@veltdev/sdk-staging 5.0.0-beta.9 → 5.0.0

package/app/models/data/comment-actions.data.model.d.ts

@@ -41,9 +41,31 @@ export interface CopyLinkRequest {
     annotationId: string;
     options?: RequestOptions;
 }
+/**
+ * Visibility type for comment annotations.
+ * - 'public': Visible to everyone (default:velt)
+ * - 'organization': Visible only to users in the specified organization
+ * - 'self': Visible only to specified users (private comments)
+ */
+export type CommentVisibilityType = 'public' | 'organization' | 'self';
+/**
+ * Configuration for comment visibility/access control.
+ */
+export interface CommentVisibilityConfig {
+    /** The type of visibility for the comment */
+    type: CommentVisibilityType;
+    /** Annotation ID for the comment to update visibility */
+    annotationId?: string;
+    /** Organization ID for 'organization' type visibility */
+    organizationId?: string;
+    /** User IDs for 'self' type visibility - array of user IDs who can see the comment */
+    userIds?: string[];
+}
 export interface AddCommentAnnotationRequest {
     annotation: CommentAnnotation;
     options?: RequestOptions;
+    /** Optional visibility configuration for the comment */
+    visibility?: CommentVisibilityConfig;
 }
 export interface ApproveCommentAnnotationRequest {
     annotationId: string;
@@ -61,6 +83,24 @@ export interface DeleteCommentAnnotationRequest {
     annotationId: string;
     options?: RequestOptions;
 }
+/**
+ * Query parameters for fetching comment annotation counts.
+ *
+ * @property organizationId - Filter by organization (enables org-wide aggregation when used alone)
+ * @property documentIds - Filter by specific document IDs
+ * @property locationIds - Filter by location IDs within documents
+ * @property statusIds - Filter by comment status IDs (e.g., "open", "resolved")
+ * @property folderId - Filter by folder ID (use with allDocuments for folder-wide counts)
+ * @property allDocuments - When true with folderId, aggregates all documents in folder
+ * @property locationId - Single location filter (deprecated, use locationIds)
+ * @property aggregateDocuments - When true, combines all documentIds into single count
+ * @property filterGhostComments - When true, excludes orphaned/deleted comments from counts
+ * @property batchedPerDocument - When true, uses efficient batched listeners (4 instead of 100)
+ *                                but still returns per-document counts. Best for large document lists (50+).
+ *                                Trade-off: slight delay on updates due to debouncing.
+ * @property debounceMs - Debounce time in milliseconds for batchedPerDocument mode (default: 5000ms).
+ *                        Prevents rapid re-fetches when multiple documents update in quick succession.
+ */
 export interface CommentRequestQuery {
     organizationId?: string;
     documentIds?: string[];
@@ -71,6 +111,10 @@ export interface CommentRequestQuery {
     locationId?: string;
     aggregateDocuments?: boolean;
     filterGhostComments?: boolean;
+    /** Enable batched listeners with per-document counts. Uses 4 listeners instead of N listeners. */
+    batchedPerDocument?: boolean;
+    /** Debounce time in ms for batchedPerDocument mode (default: 5000). */
+    debounceMs?: number;
 }
 export interface SubscribeCommentAnnotationRequest {
     annotationId: string;
@@ -170,6 +214,32 @@ export interface ToggleReactionRequest {
     };
     options?: RequestOptions;
 }
+export interface SubmitCommentRequest {
+    targetComposerElementId: string;
+}
+export interface ClearComposerRequest {
+    targetComposerElementId: string;
+}
+export interface GetComposerDataRequest {
+    targetComposerElementId: string;
+}
+/**
+ * FormatConfig - Configuration for format options
+ */
+export interface FormatConfig {
+    bold?: {
+        enable: boolean;
+    };
+    italic?: {
+        enable: boolean;
+    };
+    underline?: {
+        enable: boolean;
+    };
+    strikethrough?: {
+        enable: boolean;
+    };
+}
 export interface FetchCommentAnnotationsRequest {
     createdAfter?: number;
     createdBefore?: number;

package/app/models/data/comment-annotation.data.model.d.ts

@@ -184,6 +184,7 @@ export declare class CommentAnnotation {
     unsubscribedUsers?: CommentAnnotationUnsubscribedUsers;
     subscribedGroups?: CommentAnnotationSubscribedGroups;
     resolvedByUserId?: string | null;
+    resolvedByUser?: User | null;
     multiThreadAnnotationId?: string;
     isDraft?: boolean;
     sourceId?: string;

package/app/models/data/comment-events.data.model.d.ts

@@ -1,4 +1,4 @@
-import { CommentAccessMode, CommentEventTypes, CommentStatus } from "../../utils/enums";
+import { AssignToType, CommentAccessMode, CommentEventTypes, CommentStatus } from "../../utils/enums";
 import { Attachment } from "./attachment.model";
 import { VeltButtonClickEvent } from "./button.data.model";
 import { AddAttachmentResponse } from "./comment-actions.data.model";
@@ -84,6 +84,8 @@ export type CommentEventTypesMap = {
     [CommentEventTypes.LINK_CLICKED]: LinkClickedEvent;
     [CommentEventTypes.COMMENT_PIN_CLICKED]: CommentPinClickedEvent;
     [CommentEventTypes.COMMENT_BUBBLE_CLICKED]: CommentBubbleClickedEvent;
+    [CommentEventTypes.COMMENT_TOOL_CLICK]: CommentToolClickEvent;
+    [CommentEventTypes.SIDEBAR_BUTTON_CLICK]: SidebarButtonClickEvent;
 };
 export interface AddAttachmentEvent {
     annotationId: string;
@@ -278,5 +280,26 @@ export interface CommentBubbleClickedEvent {
 }
 export interface ComposerTextChangeEvent {
     text: string;
+    annotation: CommentAnnotation;
+    targetComposerElementId: string;
+    metadata?: VeltEventMetadata;
+}
+export interface AssignToConfig {
+    type: AssignToType;
+}
+export interface PageModeComposerConfig {
+    context?: {
+        [key: string]: any;
+    } | null;
+    targetElementId?: string | null;
+}
+export interface CommentToolClickEvent {
+    context: {
+        [key: string]: any;
+    } | null;
+    targetElementId?: string | null;
+    metadata?: VeltEventMetadata;
+}
+export interface SidebarButtonClickEvent {
     metadata?: VeltEventMetadata;
 }

package/app/models/data/config.data.model.d.ts

@@ -74,3 +74,6 @@ export interface DisableLogsConfig {
     warnings?: boolean;
     suppressAll?: boolean;
 }
+export interface GetProjectConfigResponse {
+    isPrivateCommentsEnabled: boolean;
+}

package/app/models/element/comment-element.model.d.ts

@@ -1,16 +1,16 @@
 // @ts-nocheck
 import { Observable } from "rxjs";
-import { CommentAnnotation, CommentOnElementConfig, CommentSelectionChangeData, ManualCommentAnnotationConfig, UpdateContextConfig } from "../data/comment-annotation.data.model";
-import { AcceptCommentAnnotationEvent, AddCommentAnnotationEvent, AddCommentEvent, AddReactionEvent, ApproveCommentAnnotationEvent, CommentAddEventData, CommentEventTypesMap, CommentUpdateEventData, CopyLinkEvent, DeleteAttachmentEvent, DeleteCommentAnnotationEvent, DeleteCommentEvent, DeleteReactionEvent, DeleteRecordingEvent, GetLinkEvent, RejectCommentAnnotationEvent, ToggleReactionEvent, UpdateAccessEvent, UpdateCommentEvent, UpdatePriorityEvent, UpdateStatusEvent, GetCommentAnnotationsResponse, GetCommentAnnotationsCountResponse, FetchCommentAnnotationsResponse } from "../data/comment-events.data.model";
-import { CustomCategory, CustomPriority, CustomStatus } from "../data/custom-filter.data.model";
-import { CustomAnnotationDropdownData } from "../data/custom-chip-dropdown.data.model";
+import { AssignToType, CommentSidebarSystemFiltersOperator, SidebarButtonCountType } from "../../utils/enums";
+import { UploadFileData } from "../data/attachment.model";
 import { AutocompleteData } from "../data/autocomplete.data.model";
+import { AcceptCommentAnnotationRequest, AddAttachmentRequest, AddAttachmentResponse, AddCommentAnnotationRequest, AddCommentRequest, AddReactionRequest, ApproveCommentAnnotationRequest, AssignUserEvent, AssignUserRequest, CommentRequestQuery, CommentVisibilityConfig, ClearComposerRequest, CopyLinkRequest, DeleteAttachmentRequest, DeleteCommentAnnotationRequest, DeleteCommentRequest, DeleteReactionRequest, DeleteRecordingRequest, FetchCommentAnnotationsRequest, GetAttachmentRequest, GetCommentRequest, GetComposerDataRequest, GetLinkRequest, GetRecordingRequest, RejectCommentAnnotationRequest, ResolveCommentAnnotationRequest, SubmitCommentRequest, SubscribeCommentAnnotationRequest, ToggleReactionRequest, UnsubscribeCommentAnnotationRequest, UpdateAccessRequest, UpdateCommentRequest, UpdatePriorityRequest, UpdateStatusRequest } from "../data/comment-actions.data.model";
+import { CommentAnnotation, CommentOnElementConfig, CommentSelectionChangeData, ManualCommentAnnotationConfig, UpdateContextConfig } from "../data/comment-annotation.data.model";
+import { AcceptCommentAnnotationEvent, AddCommentAnnotationEvent, AddCommentEvent, AddReactionEvent, ApproveCommentAnnotationEvent, AssignToConfig, CommentAddEventData, CommentEventTypesMap, CommentUpdateEventData, ComposerTextChangeEvent, CopyLinkEvent, DeleteAttachmentEvent, DeleteCommentAnnotationEvent, DeleteCommentEvent, DeleteReactionEvent, DeleteRecordingEvent, FetchCommentAnnotationsResponse, GetCommentAnnotationsCountResponse, GetCommentAnnotationsResponse, GetLinkEvent, PageModeComposerConfig, RejectCommentAnnotationEvent, ToggleReactionEvent, UpdateAccessEvent, UpdateCommentEvent, UpdatePriorityEvent, UpdateStatusEvent } from "../data/comment-events.data.model";
 import { CommentSidebarCustomActionEventData, CommentSidebarData, CommentSidebarDataOptions } from "../data/comment-sidebar-config.model";
+import { CommentContextProvider, FormatConfig, TransformContext, UnreadCommentsCount } from "../data/comment-utils.data.model";
+import { CustomAnnotationDropdownData } from "../data/custom-chip-dropdown.data.model";
+import { CustomCategory, CustomPriority, CustomStatus } from "../data/custom-filter.data.model";
 export { ReactionMap } from '../data/reaction-annotation.data.model';
-import { AcceptCommentAnnotationRequest, AddAttachmentRequest, AddAttachmentResponse, AddCommentAnnotationRequest, AddCommentRequest, AddReactionRequest, ApproveCommentAnnotationRequest, AssignUserRequest, AssignUserEvent, CopyLinkRequest, DeleteAttachmentRequest, DeleteCommentAnnotationRequest, CommentRequestQuery, CommentRequestQuery, DeleteCommentRequest, DeleteReactionRequest, DeleteRecordingRequest, GetAttachmentRequest, GetCommentRequest, GetLinkRequest, GetRecordingRequest, RejectCommentAnnotationRequest, ResolveCommentAnnotationRequest, SubscribeCommentAnnotationRequest, UnsubscribeCommentAnnotationRequest, ToggleReactionRequest, UpdateAccessRequest, UpdateCommentRequest, UpdatePriorityRequest, UpdateStatusRequest, FetchCommentAnnotationsRequest } from "../data/comment-actions.data.model";
-import { CommentContextProvider, UnreadCommentsCount, TransformContext } from "../data/comment-utils.data.model";
-import { CommentSidebarSystemFiltersOperator, SidebarButtonCountType } from "../../utils/enums";
-import { UploadFileData } from "../data/attachment.model";
 
 export declare class CommentElement {
   /**
@@ -85,6 +85,39 @@ export declare class CommentElement {
    */
   toggleCommentSidebar: () => any;
 
+  /**
+   * To enable context in page mode composer feature
+   * When enabled, clicking comment tool will open sidebar with page mode composer and pass context
+   */
+  enableContextInPageModeComposer: () => void;
+
+  /**
+   * To disable context in page mode composer feature
+   */
+  disableContextInPageModeComposer: () => void;
+
+  /**
+   * To clear page mode composer context
+   */
+  clearPageModeComposerContext: () => void;
+
+  /**
+   * To set context in page mode composer
+   * @param config The page mode composer config containing context and targetElementId
+   */
+  setContextInPageModeComposer: (config: PageModeComposerConfig | null) => void;
+
+  /**
+   * To focus the page mode composer input
+   */
+  focusPageModeComposer: () => void;
+
+  /**
+   * To set assign to type for comment dialog
+   * @param config The assign to config containing type
+   */
+  setAssignToType: (config: AssignToConfig) => void;
+
   /**
   * To enable moderator mode
   */
@@ -465,11 +498,13 @@ export declare class CommentElement {
   /**
    * To enable private comment mode to add private comments.
    * This mode can be enabled for admin users only.
+   * @deprecated
    */
   public enablePrivateCommentMode: () => void;
 
   /**
    * To disable private comment mode.
+   * @deprecated
    */
   public disablePrivateCommentMode: () => void;
 
@@ -823,6 +858,13 @@ export declare class CommentElement {
    */
   public updateContext: (annotationId: string, context: any, config?: UpdateContextConfig) => Promise<any>;
 
+  /**
+   * Updates the visibility of a comment annotation.
+   * @param visibility Visibility configuration (public, organization, or self) including annotationId
+   * @returns Promise<any>
+   */
+  public updateVisibility: (visibility: CommentVisibilityConfig) => Promise<any>;
+
   /**
    * Subscribe to selected comments
    * @returns list of selected comments
@@ -1011,6 +1053,7 @@ export declare class CommentElement {
 
   /**
    * To update access
+   * @deprecated
    */
   public updateAccess: (request: UpdateAccessRequest) => Promise<UpdateAccessEvent | null>;
 
@@ -1264,13 +1307,6 @@ export declare class CommentElement {
    */
   public disableScreenshot: () => void;
 
-  /**
-   * To programmatically submit a comment from a velt-comment-composer.
-   * Finds the composer within the element identified by referenceId and submits its content.
-   * @param referenceId The ID of the HTML element containing the velt-comment-composer
-   */
-  public submitComment: (referenceId: string) => void;
-
   /**
    * To enable paginated contact list
    */
@@ -1281,6 +1317,42 @@ export declare class CommentElement {
    */
   public disablePaginatedContactList: () => void;
 
+  /**
+   * To enable format options (bold, italic, underline, strikethrough)
+   */
+  public enableFormatOptions: () => void;
+
+  /**
+   * To disable format options
+   */
+  public disableFormatOptions: () => void;
+
+  /**
+   * Set format config to control which format options are enabled
+   * @param config FormatConfig with enable flags for each format type
+   */
+  public setFormatConfig: (config: FormatConfig) => void;
+
+  /**
+   * Programmatically trigger comment submission for a composer with the given targetComposerElementId
+   * @param request SubmitCommentRequest containing targetComposerElementId
+   */
+  public submitComment: (request: SubmitCommentRequest) => void;
+
+  /**
+   * Programmatically clear the composer state for the given targetComposerElementId
+   * @param request ClearComposerRequest containing targetComposerElementId
+   */
+  public clearComposer: (request: ClearComposerRequest) => void;
+
+  /**
+   * Get the current composer data for a given targetComposerElementId
+   * Returns the same data as COMPOSER_TEXT_CHANGE event but as a one-time fetch
+   * @param request GetComposerDataRequest containing targetComposerElementId
+   * @returns The composer data or null if not found
+   */
+  public getComposerData: (request: GetComposerDataRequest) => ComposerTextChangeEvent | null;
+
   constructor();
   /**
    * Subscribe to comments on the current document.
@@ -2082,6 +2154,14 @@ export declare class CommentElement {
    */
   private _updateContext;
 
+  /**
+   * Updates the visibility of a comment annotation.
+   * @param annotationId Annotation Id
+   * @param visibility Visibility configuration (public, organization, or self)
+   * @returns Promise<any>
+   */
+  private _updateVisibility;
+
   /**
    * Subscribe to selected comments
    * @returns list of selected comments
@@ -2533,11 +2613,68 @@ export declare class CommentElement {
    * To disable paginated contact list
    */
   private _disablePaginatedContactList;
+  /**
+   * To enable format options (bold, italic, underline, strikethrough)
+   */
+  private _enableFormatOptions;
+  /**
+   * To disable format options
+   */
+  private _disableFormatOptions;
+  /**
+   * To set format config to control which format options are enabled
+   * @param config FormatConfig with enable flags for each format type
+   */
+  private _setFormatConfig;
 
   /**
-   * To programmatically submit a comment from a velt-comment-composer.
-   * Finds the composer within the element identified by referenceId and submits its content.
-   * @param referenceId The ID of the HTML element containing the velt-comment-composer
+   * Programmatically trigger comment submission for a composer with the given targetComposerElementId
+   * @param request SubmitCommentRequest containing targetComposerElementId
    */
   private _submitComment;
+
+  /**
+   * Programmatically clear the composer state for the given targetComposerElementId
+   * @param request ClearComposerRequest containing targetComposerElementId
+   */
+  private _clearComposer;
+
+  /**
+   * Get the current composer data for a given targetComposerElementId
+   * Returns the same data as COMPOSER_TEXT_CHANGE event but as a one-time fetch
+   * @param request GetComposerDataRequest containing targetComposerElementId
+   * @returns The composer data or null if not found
+   */
+  private _getComposerData;
+
+  /**
+   * To enable context in page mode composer feature
+   */
+  private _enableContextInPageModeComposer;
+
+  /**
+   * To disable context in page mode composer feature
+   */
+  private _disableContextInPageModeComposer;
+
+  /**
+   * To clear page mode composer context
+   */
+  private _clearPageModeComposerContext;
+
+  /**
+   * To set context in page mode composer
+   */
+  private _setContextInPageModeComposer;
+
+  /**
+   * To focus the page mode composer input
+   */
+  private _focusPageModeComposer;
+
+  /**
+   * To set assign to type for comment dialog
+   * @param type 'dropdown' | 'checkbox'
+   */
+  private _setAssignToType;
 }

package/app/models/element/notification-element.model.d.ts

@@ -68,6 +68,16 @@ export declare class NotificationElement {
      */
     getSettings: () => Observable<NotificationSettingsConfig | null>;
 
+    /**
+     * To enable settings config by organization
+     */
+    enableSettingsAtOrganizationLevel: () => void;
+
+    /**
+     * To disable settings config by organization
+     */
+    disableSettingsAtOrganizationLevel: () => void;
+
     /**
      * To mute all notifications
      */
@@ -200,6 +210,16 @@ export declare class NotificationElement {
      */
     private _disableSettings;
 
+    /**
+     * To enable settings config by organization
+     */
+    private _enableSettingsAtOrganizationLevel;
+
+    /**
+     * To disable settings config by organization
+     */
+    private _disableSettingsAtOrganizationLevel;
+
     /**
      * To enable self notifications
      */

package/app/utils/constants.d.ts

@@ -11,6 +11,7 @@ export declare class Constants {
     static LISTENER_BATCH_SIZE: number;
     static LISTENER_CONTEXT_BATCH_SIZE: number;
     static DEFAULT_VELT_CONTEXT: string;
+    static VISIBILITY_SELF_PREFIX: string;
     static FIREBASE_PARTIAL_PATH_ORGANIZATIONS: string;
     static FIREBASE_PARTIAL_PATH_FOLDERS: string;
     static FIREBASE_PARTIAL_PATH_DOCS: string;

package/app/utils/enums.d.ts

@@ -59,6 +59,8 @@ export declare const CommentEventTypes: {
     readonly LINK_CLICKED: "linkClicked";
     readonly COMMENT_PIN_CLICKED: "commentPinClicked";
     readonly COMMENT_BUBBLE_CLICKED: "commentBubbleClicked";
+    readonly COMMENT_TOOL_CLICK: "commentToolClick";
+    readonly SIDEBAR_BUTTON_CLICK: "sidebarButtonClick";
 };
 export declare const RecorderEventTypes: {
     readonly TRANSCRIPTION_DONE: "transcriptionDone";
@@ -187,6 +189,7 @@ export declare enum AnalyticsFeatures {
     COMMENT_SIDEBAR = "commentSidebar"
 }
 export type FeatureType = 'area' | 'arrow' | 'audioHuddle' | 'comment' | 'cursor' | 'huddle' | 'liveStateSync' | 'presence' | 'recorder' | 'rewriter' | 'tag' | 'liveSelection' | 'notification' | 'reaction' | 'multiThread';
+export type AssignToType = 'dropdown' | 'checkbox';
 export declare enum DeviceType {
     DESKTOP = "Desktop",
     MOBILE = "Mobile",
@@ -279,10 +282,10 @@ export type OverlayOriginY = 'top' | 'center' | 'bottom';
 export type OverlayOriginX = 'start' | 'center' | 'end';
 export type SubtitlesMode = 'floating' | 'embed';
 export type RecorderVariant = 'default' | 'embed';
-export type ReactionPinType = 'timeline' | 'comment';
+export type ReactionPinType = 'timeline' | 'comment' | 'standalone';
 export type SidebarPosition = 'left' | 'right';
 export type SidebarSortingCriteria = 'date' | 'unread' | null;
-export type SidebarFilterCriteria = 'all' | 'read' | 'unread' | 'resolved' | 'open' | 'reset' | null;
+export type SidebarFilterCriteria = 'all' | 'read' | 'unread' | 'resolved' | 'open' | 'assignedToMe' | 'reset' | null;
 export type SidebarFilterSearchType = 'people' | 'assigned' | 'tagged' | 'involved' | 'pages' | 'documents' | 'statuses' | 'priorities' | 'categories' | 'versions' | string;
 export type InlineSortingCriteria = 'createdFirst' | 'createdLast' | 'updatedFirst' | 'updatedLast';
 export type NotificationPanelMode = 'popover' | 'sidebar';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@veltdev/sdk-staging",
-    "version": "5.0.0-beta.9",
+    "version": "5.0.0",
     "description": "Velt is an SDK to add collaborative features to your product within minutes. Example: Comments like Figma, Frame.io, Google docs or sheets, Recording like Loom, Huddles like Slack and much more.",
     "homepage": "https://velt.dev",
     "keywords": [