@veltdev/sdk-staging 5.0.2-beta.8 → 5.0.2-beta.80

package/app/client/snippyly.model.d.ts

@@ -5,6 +5,7 @@ import { DocumentUser } from "../models/data/document-user.data.model";
 import { Location } from "../models/data/location.model";
 import { User, UserOptions, VeltAuthProvider, VeltPermissionProvider } from "../models/data/user.data.model";
 import { CustomCss } from "../models/data/custom-css.data.model";
+import { ActivityElement } from "../models/element/activity-element.model";
 import { AreaElement } from "../models/element/area-element.model";
 import { ArrowElement } from "../models/element/arrow-element.model";
 import { CommentElement } from "../models/element/comment-element.model";
@@ -29,7 +30,7 @@ import { VeltEventMetadata, VeltDebugInfo } from "../models/data/event-metadata.
 import { CoreEventTypesMap } from "../models/data/core-events.data.model";
 import { Document, SetDocumentsRequestOptions, FetchDocumentsRequest, FetchFoldersRequest, UpdateDocumentsRequest, UpdateLocationsRequest } from "../models/data/document.data.model";
 import { FetchDocumentsResponse, FetchFoldersResponse } from "../models/data/document-events.data.model";
-import { UserDataProvider, GetUserPermissionsRequest, GetUserPermissionsResponse } from "../models/data/user-resolver.data.model";
+import { AnonymousUserDataProvider, UserDataProvider, GetUserPermissionsRequest, GetUserPermissionsResponse } from "../models/data/user-resolver.data.model";
 import { VeltDataProvider } from "../models/data/provider.data.model";
 import { VeltEncryptionProvider } from "../models/data/encryption-provider.data.model";
 import { VeltResetButtonStateConfig } from "../models/data/button.data.model";
@@ -97,6 +98,10 @@ export declare class Snippyly {
     * To set the user data provider.
     */
    setUserDataProvider: (userDataProvider: UserDataProvider) => void;
+   /**
+    * To set the anonymous user data provider.
+    */
+   setAnonymousUserDataProvider: (resolver: AnonymousUserDataProvider, config?: { ha?: boolean }) => void;
    /**
     * To set the data provider.
     */
@@ -228,6 +233,10 @@ export declare class Snippyly {
     * Get the Autocomplete Object.
     */
    getAutocompleteElement: () => AutocompleteElement;
+   /**
+    * Get the Activity Element Object.
+    */
+   getActivityElement: () => ActivityElement;
    /**
     * Get the Area Object.
     */
@@ -356,7 +365,7 @@ export declare class Snippyly {
    /**
     * To update user contact list.
     */
-   updateContactList: (userContacts: UserContact[], config?: { merge: boolean }) => void;
+   updateContactList: (userContacts: UserContact[], config?: { merge: boolean, filters?: boolean }) => void;
 
    /**
     * To get document metadata.
@@ -399,6 +408,16 @@ export declare class Snippyly {
     */
    disableSafeEval: () => void;
 
+   /**
+    * Enable Firestore persistent cache for offline support.
+    */
+   enableFirestorePersistentCache: (config?: { ha?: boolean }) => void;
+
+   /**
+    * Disable Firestore persistent cache.
+    */
+   disableFirestorePersistentCache: (config?: { ha?: boolean }) => void;
+
    /**
     * To reset the button toggle map.
     */

package/app/models/data/activity-resolver.data.model.d.ts

@@ -0,0 +1,27 @@
+import { BaseMetadata } from './base-metadata.data.model';
+import { ActivityChanges } from './activity.data.model';
+import { ResolverConfig, ResolverResponse } from './resolver.data.model';
+export interface PartialActivityRecord {
+    id: string;
+    metadata?: BaseMetadata;
+    changes?: ActivityChanges;
+    entityData?: unknown;
+    entityTargetData?: unknown;
+    displayMessageTemplateData?: Record<string, unknown>;
+    [key: string]: any;
+}
+export interface ActivityAnnotationDataProvider {
+    get?: (request: GetActivityResolverRequest) => Promise<ResolverResponse<Record<string, PartialActivityRecord>>>;
+    save?: (request: SaveActivityResolverRequest) => Promise<ResolverResponse<undefined>>;
+    config?: ResolverConfig;
+}
+export interface GetActivityResolverRequest {
+    activityIds?: string[];
+    documentIds?: string[];
+    organizationId?: string;
+}
+export interface SaveActivityResolverRequest {
+    activity: Record<string, PartialActivityRecord>;
+    event?: string;
+    metadata?: BaseMetadata;
+}

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

@@ -0,0 +1,181 @@
+import { Observable } from 'rxjs';
+import { BaseMetadata } from './base-metadata.data.model';
+import { User } from './user.data.model';
+/**
+ * Feature types that can generate activities.
+ */
+export type ActivityFeatureType = 'comment' | 'reaction' | 'recorder' | 'crdt' | 'custom';
+/**
+ * Comment action type constants following the `entity_type.action` naming pattern.
+ * Annotation-level actions use `comment_annotation.*`, comment-level use `comment.*`.
+ */
+export declare const CommentActivityActionTypes: {
+    readonly ANNOTATION_ADD: "comment_annotation.add";
+    readonly ANNOTATION_DELETE: "comment_annotation.delete";
+    readonly COMMENT_ADD: "comment.add";
+    readonly COMMENT_UPDATE: "comment.update";
+    readonly COMMENT_DELETE: "comment.delete";
+    readonly STATUS_CHANGE: "comment_annotation.status_change";
+    readonly PRIORITY_CHANGE: "comment_annotation.priority_change";
+    readonly ASSIGN: "comment_annotation.assign";
+    readonly ACCESS_MODE_CHANGE: "comment_annotation.access_mode_change";
+    readonly CUSTOM_LIST_CHANGE: "comment_annotation.custom_list_change";
+    readonly APPROVE: "comment_annotation.approve";
+    readonly ACCEPT: "comment.accept";
+    readonly REJECT: "comment.reject";
+    readonly SUGGESTION_ACCEPT: "comment_annotation.suggestion_accept";
+    readonly SUGGESTION_REJECT: "comment_annotation.suggestion_reject";
+    readonly REACTION_ADD: "comment.reaction_add";
+    readonly REACTION_DELETE: "comment.reaction_delete";
+    readonly SUBSCRIBE: "comment_annotation.subscribe";
+    readonly UNSUBSCRIBE: "comment_annotation.unsubscribe";
+};
+export type CommentActivityActionType = typeof CommentActivityActionTypes[keyof typeof CommentActivityActionTypes];
+/**
+ * Recorder action type constants following the `recording.*` naming pattern.
+ */
+export declare const RecorderActivityActionTypes: {
+    readonly RECORDING_ADD: "recording.add";
+    readonly RECORDING_DELETE: "recording.delete";
+};
+export type RecorderActivityActionType = typeof RecorderActivityActionTypes[keyof typeof RecorderActivityActionTypes];
+/**
+ * Reaction action type constants following the `reaction.*` naming pattern.
+ */
+export declare const ReactionActivityActionTypes: {
+    readonly REACTION_ADD: "reaction.add";
+    readonly REACTION_DELETE: "reaction.delete";
+};
+export type ReactionActivityActionType = typeof ReactionActivityActionTypes[keyof typeof ReactionActivityActionTypes];
+/**
+ * CRDT action type constants following the `crdt.*` naming pattern.
+ */
+export declare const CrdtActivityActionTypes: {
+    readonly EDITOR_EDIT: "crdt.editor_edit";
+};
+export type CrdtActivityActionType = typeof CrdtActivityActionTypes[keyof typeof CrdtActivityActionTypes];
+/**
+ * Represents a single from/to change pair.
+ * `from` is always present (null for 'added' events) for uniform structure.
+ */
+export interface ActivityChange<T = unknown> {
+    from?: T | null;
+    to?: T | null;
+}
+/**
+ * Dynamic change tracking. Keys are domain-specific (e.g., 'status', 'commentText', 'assignedTo').
+ * No fixed keys — activities span multiple features.
+ */
+export interface ActivityChanges {
+    [key: string]: ActivityChange | undefined;
+}
+/**
+ * Metadata for activity records. Extends BaseMetadata with denormalized IDs
+ * for efficient querying at the organization level.
+ */
+export declare class ActivityMetadata extends BaseMetadata {
+    [key: string]: any;
+}
+/**
+ * Core activity record representing a single activity event.
+ *
+ * @typeParam TEntity - Type of the parent entity snapshot (e.g., CommentAnnotation)
+ * @typeParam TTarget - Type of the sub-entity snapshot (e.g., Comment)
+ */
+export declare class ActivityRecord<TEntity = unknown, TTarget = unknown> {
+    /** Auto-generated unique ID */
+    id: string;
+    /** Feature that generated this activity */
+    featureType: ActivityFeatureType;
+    /** Action that occurred, following `entity_type.action` pattern */
+    actionType: string;
+    /** Event type that occurred */
+    eventType?: string;
+    /** User who performed the action */
+    actionUser: User;
+    /** Server timestamp (set by backend) */
+    timestamp: number;
+    /** Denormalized IDs for querying */
+    metadata: ActivityMetadata;
+    /** ID of the parent entity (annotationId, recordingId, etc.) */
+    targetEntityId: string;
+    /** ID of the sub-entity acted on (commentId within annotation, null for entity-level actions) */
+    targetSubEntityId?: string | null;
+    /** Linear-style from/to change pairs */
+    changes?: ActivityChanges;
+    /** Full parent entity snapshot at time of action */
+    entityData?: TEntity;
+    /** Sub-entity snapshot (or user-provided data for custom activities) */
+    entityTargetData?: TTarget;
+    /** Display message template — ONLY for custom activities */
+    displayMessageTemplate?: string;
+    /** Template variable values — ONLY for custom activities */
+    displayMessageTemplateData?: Record<string, unknown>;
+    /** Computed display message (generated client-side, never stored in Firestore) */
+    displayMessage?: string;
+    /** Icon URL or identifier for display */
+    actionIcon?: string;
+    /** If true, this activity cannot be updated or deleted via REST API */
+    immutable?: boolean;
+    /** If true, this activity was stripped by the activity resolver (for UI loading states) */
+    isActivityResolverUsed?: boolean;
+}
+/**
+ * Configuration for subscribing to activities.
+ * Behavior is determined by the props passed:
+ * - No config → org-wide
+ * - documentIds → specific documents
+ * - currentDocumentOnly → current document only
+ */
+export interface ActivitySubscribeConfig {
+    /** Subscribe to activities for a specific organization (defaults to current org) */
+    organizationId?: string;
+    /** Subscribe to activities for specific document IDs */
+    documentIds?: string[];
+    /** Subscribe to activities for the current document only (auto-switches on setDocument) */
+    currentDocumentOnly?: boolean;
+    /** Only fetch activities from the last N days (default: 30) */
+    maxDays?: number;
+    /** Allowlist: only include activities with these feature types */
+    featureTypes?: ActivityFeatureType[];
+    /** Disallowlist: exclude activities with these feature types (ignored if featureTypes is set) */
+    excludeFeatureTypes?: ActivityFeatureType[];
+    /** Allowlist: only include activities with these action types */
+    actionTypes?: string[];
+    /** Disallowlist: exclude activities with these action types (ignored if actionTypes is set) */
+    excludeActionTypes?: string[];
+    /** Allowlist: only include activities by these user IDs */
+    userIds?: string[];
+    /** Disallowlist: exclude activities by these user IDs (ignored if userIds is set) */
+    excludeUserIds?: string[];
+}
+/**
+ * Represents an active activity subscription.
+ * Returned by `activityService.subscribe()`.
+ */
+export interface ActivitySubscription {
+    /** Observable stream of activities for this subscription's scope. null = not yet loaded. */
+    getActivities$(): Observable<ActivityRecord[] | null>;
+    /** Unsubscribe and clean up this subscription */
+    unsubscribe(): void;
+}
+/**
+ * Data required to create an activity.
+ * Used for all activity types: comment, reaction, recorder, custom, etc.
+ */
+export interface CreateActivityData<TEntity = unknown, TTarget = unknown> {
+    featureType: ActivityFeatureType;
+    actionType: string;
+    eventType?: string;
+    targetEntityId: string;
+    targetSubEntityId?: string | null;
+    changes?: ActivityChanges;
+    entityData?: TEntity;
+    entityTargetData?: TTarget;
+    /** Icon URL or identifier — typically used for custom activities */
+    actionIcon?: string;
+    /** Display message template — only for custom activities */
+    displayMessageTemplate?: string;
+    /** Template variable values — only for custom activities */
+    displayMessageTemplateData?: Record<string, unknown>;
+}

package/app/models/data/agent-suggestion.data.model.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Public configuration surface for AI agent suggestion comment actions.
+ *
+ * Hosts can override or augment the built-in accept (convert suggestion ->
+ * comment) and reject (delete) actions rendered on an agent suggestion card.
+ * When no config is provided, the built-in defaults are used (INV-004).
+ *
+ * Part of the SDK public API (exported via velt-types). Backward-compatible /
+ * additive — see specs/agent-suggestion-comment-ui/spec.md `## Outbound contract changes`.
+ */
+import { CommentAnnotation } from './comment-annotation.data.model';
+/**
+ * A single host-defined action button on an agent suggestion card.
+ */
+export interface AgentSuggestionAction {
+    /** Stable identifier for the action. */
+    id: string;
+    /** Display label (button text / aria-label). */
+    label?: string;
+    /** Optional icon identifier or URL. */
+    icon?: string;
+    /**
+     * Invoked when the action button is clicked. Receives the raw
+     * CommentAnnotation (review decision 2026-06-03 — accepted public-contract
+     * surface). Handler throws are caught by the SDK (EC-006).
+     */
+    onClick: (annotation: CommentAnnotation) => void | Promise<void>;
+}
+/**
+ * Host configuration for agent suggestion card actions.
+ * When `actions` is provided it replaces the default accept/reject pair.
+ */
+export interface AgentSuggestionActionsConfig {
+    actions?: AgentSuggestionAction[];
+}
+/**
+ * Discriminator for the bespoke agent-suggestion overflow-menu rows.
+ * Drives the icon, label and click action of the generic menu-item primitive.
+ */
+export type AgentSuggestionMenuItemType = 'copy-link' | 'delete';
+/**
+ * Canonical agent-suggestion overflow-menu item types.
+ * Avoids repeating the discriminator string literals across primitives.
+ */
+export declare const AGENT_SUGGESTION_MENU_ITEM_TYPE: {
+    readonly COPY_LINK: "copy-link";
+    readonly DELETE: "delete";
+};
+/**
+ * Translation keys / labels used by the agent-suggestion overflow menu.
+ * Centralised so the menu-item, label and trigger primitives stay in sync.
+ */
+export declare const AGENT_SUGGESTION_MENU_LABEL: {
+    readonly COPY_LINK: "Copy link";
+    readonly LINK_COPIED: "Link copied!";
+    readonly DELETE_THREAD: "Delete thread";
+};

package/app/models/data/attachment-resolver.data.model.d.ts

@@ -1,8 +1,8 @@
 import { ResolverActions } from "../../utils/enums";
 import { ResolverConfig, ResolverResponse } from "./resolver.data.model";
 export interface AttachmentDataProvider {
-    save: (request: SaveAttachmentResolverRequest) => Promise<ResolverResponse<SaveAttachmentResolverData>>;
-    delete: (request: DeleteAttachmentResolverRequest) => Promise<ResolverResponse<undefined>>;
+    save?: (request: SaveAttachmentResolverRequest) => Promise<ResolverResponse<SaveAttachmentResolverData>>;
+    delete?: (request: DeleteAttachmentResolverRequest) => Promise<ResolverResponse<undefined>>;
     config?: ResolverConfig;
 }
 export interface DeleteAttachmentResolverRequest {

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

@@ -53,6 +53,7 @@ export interface UploadFileOptions {
     file: File;
     useAttachmentResolver?: boolean;
     metadata?: any;
+    attachmentScope?: string;
 }
 export interface UploadFileData {
     files: File[];

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

@@ -22,19 +22,20 @@ export declare class AutocompleteItem {
     groupId?: string;
 }
 export declare class AutocompleteReplaceData {
-    text: string;
+    text?: string;
     custom: AutocompleteItem;
 }
 export declare class AutocompleteGroupReplaceData {
-    text: string;
+    text?: string;
     groupId: string;
     clientGroupId: string;
     group?: OrganizationUserGroup;
 }
 export declare class AutocompleteUserContactReplaceData {
-    text: string;
+    text?: string;
     userId: string;
     contact?: UserContact;
+    isEmailValid?: boolean;
 }
 export declare class AutocompleteGroup {
     id: string;

package/app/models/data/base-metadata.data.model.d.ts

@@ -1,3 +1,4 @@
+import { DocumentMetadata } from './document-metadata.model';
 export declare class BaseMetadata {
     apiKey?: string;
     documentId?: string;
@@ -6,4 +7,6 @@ export declare class BaseMetadata {
     clientOrganizationId?: string;
     folderId?: string;
     veltFolderId?: string;
+    documentMetadata?: DocumentMetadata;
+    sdkVersion?: string | null;
 }

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

@@ -85,6 +85,16 @@ export interface RejectCommentAnnotationRequest {
     annotationId: string;
     options?: RequestOptions;
 }
+export interface AcceptSuggestionRequest {
+    annotationId: string;
+    options?: RequestOptions;
+}
+export interface RejectSuggestionRequest {
+    annotationId: string;
+    /** Optional human-readable reason persisted on the suggestion. */
+    reason?: string;
+    options?: RequestOptions;
+}
 export interface DeleteCommentAnnotationRequest {
     annotationId: string;
     options?: RequestOptions;
@@ -121,6 +131,8 @@ export interface CommentRequestQuery {
     batchedPerDocument?: boolean;
     /** Debounce time in ms for batchedPerDocument mode (default: 5000). */
     debounceMs?: number;
+    /** Filter annotations by agent fields. Matches annotations where `agent.agentFields` array contains any of the provided values. */
+    agentFields?: string[];
 }
 export interface SubscribeCommentAnnotationRequest {
     annotationId: string;
@@ -141,6 +153,8 @@ export interface AddCommentRequest {
     assignedTo?: User;
     assigned?: boolean;
     options?: RequestOptions;
+    /** Optional visibility configuration for the comment */
+    visibility?: CommentVisibilityConfig;
 }
 export interface UpdateCommentRequest {
     annotationId: string;

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

@@ -1,15 +1,50 @@
-import { CommentAccessMode } from "../../utils/enums";
+import { CommentAccessMode, CommentVisibilityOptionType } from "../../utils/enums";
 import { BaseMetadata } from "./base-metadata.data.model";
+import { CommentVisibilityType } from "./comment-actions.data.model";
 import { Comment } from "./comment.data.model";
 import { CursorPosition } from "./cursor-position.data.model";
 import { CustomAnnotationDropdownItem } from "./custom-chip-dropdown.data.model";
 import { CustomCategory, CustomPriority, CustomStatus } from "./custom-filter.data.model";
 import { Location } from "./location.model";
 import { PageInfo } from "./page-info.model";
+import { SuggestionData } from "./suggestion.data.model";
 import { TargetElement } from "./target-element.data.model";
 import { TargetTextRange } from "./target-text-range.data.model";
 import { User } from "./user.data.model";
 import { CommentAnnotationViews } from "./views.data.model";
+export interface CommentAnnotationVisibilityConfig {
+    type: CommentVisibilityType;
+    organizationId?: string;
+    userIds?: string[];
+}
+/**
+ * Structured result produced by an AI agent for a comment annotation.
+ * Read-only from the SDK's perspective — written upstream by the agent.
+ */
+export interface AgentResult {
+    /** Short, bold headline rendered at the top of the agent suggestion card. */
+    title?: string;
+}
+/**
+ * Identity + output of the AI agent that authored a comment annotation.
+ * Present on annotations created by an agent. The agent-suggestion UI renders
+ * iff `agent` is present AND `type === 'suggestion'` (and the viewer is admin).
+ *
+ * `agentFields` mirrors the Firestore query field used by
+ * `CommentRequestQuery.agentFields` (see comment-actions.data.model.ts).
+ */
+export interface AgentData {
+    /** Canonical display name of the agent (card header). */
+    agentName?: string;
+    /** Legacy display name of the agent (card header); superseded by `agentName`. */
+    name?: string;
+    /** Avatar URL for the agent (card header); falls back to a default icon. */
+    avatar?: string;
+    /** Structured agent output (title, …). */
+    result?: AgentResult;
+    /** Queryable agent attributes. */
+    agentFields?: string[];
+}
 export declare class CommentAnnotation {
     /**
      * Unique identifier for the comment pin annotation.
@@ -23,6 +58,7 @@ export declare class CommentAnnotation {
      * Auto generated.
      */
     annotationNumber?: number;
+    visibilityConfig?: CommentAnnotationVisibilityConfig;
     /**
      * This is the list of all comments part of this annotation.
      *
@@ -143,6 +179,12 @@ export declare class CommentAnnotation {
     location?: Location | null;
     type?: string;
     commentType?: string;
+    /**
+     * Origin of the annotation. `'agent'` indicates the annotation was authored by
+     * an AI agent (drives the blue pin marker, agent identity header and blue text
+     * highlight). Absent / any other value indicates a regular user comment.
+     */
+    sourceType?: string;
     metadata?: CommentMetadata;
     /**
      * Selected text range of comment annotation
@@ -154,6 +196,10 @@ export declare class CommentAnnotation {
     selectAllContent?: boolean;
     approved?: boolean;
     status: CustomStatus;
+    /**
+     * User id of the user who updated the status of the comment annotation
+     */
+    statusUpdatedByUserId?: string | null;
     /**
      * To maintain index of current annotation in available list of annotations
      * It will start from 1, so no need to add 1 in that.
@@ -192,6 +238,19 @@ export declare class CommentAnnotation {
     viewedByUserIds?: string[];
     viewedBy?: User[];
     unread?: boolean;
+    /**
+     * SDK-managed suggestion data. Present iff type === 'suggestion'.
+     * Customer code must not write to this directly — use the SuggestionElement API.
+     *
+     * See docs/suggestions-api-contract.md for the full storage model.
+     */
+    suggestion?: SuggestionData;
+    /**
+     * AI agent identity + output. Present on agent-authored annotations.
+     * Read-only from the SDK; written upstream by the agent.
+     * See specs/agent-suggestion-comment-ui/spec.md (INV-001).
+     */
+    agent?: AgentData;
 }
 export declare class GhostComment {
     targetElement?: TargetElement | null;
@@ -234,7 +293,8 @@ export declare class CommentSelectionChangeData {
 }
 export declare class VisibilityOptionClickedData {
     annotationId: string;
-    visibility: 'public' | 'private';
+    visibility: CommentVisibilityOptionType;
+    users?: any[];
 }
 export declare class InlineCommentSectionConfig {
     id: string;

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

@@ -1,4 +1,4 @@
-import { AssignToType, CommentAccessMode, CommentEventTypes, CommentStatus } from "../../utils/enums";
+import { AssignToType, CommentAccessMode, CommentEventTypes, CommentStatus, CommentVisibilityOptionType } from "../../utils/enums";
 import { Attachment } from "./attachment.model";
 import { VeltButtonClickEvent } from "./button.data.model";
 import { AddAttachmentResponse } from "./comment-actions.data.model";
@@ -67,6 +67,7 @@ export type CommentEventTypesMap = {
     [CommentEventTypes.UPDATE_ACCESS]: UpdateAccessEvent;
     [CommentEventTypes.RESOLVE_COMMENT]: ResolveCommentEvent;
     [CommentEventTypes.ADD_COMMENT]: AddCommentEvent;
+    [CommentEventTypes.ADD_COMMENT_DRAFT]: AddCommentDraftEvent;
     [CommentEventTypes.UPDATE_COMMENT]: UpdateCommentEvent;
     [CommentEventTypes.DELETE_COMMENT]: DeleteCommentEvent;
     [CommentEventTypes.ADD_ATTACHMENT]: AddAttachmentEvent;
@@ -92,6 +93,8 @@ export type CommentEventTypesMap = {
     [CommentEventTypes.COMMENT_SAVED]: CommentSavedEvent;
     [CommentEventTypes.COMMENT_SAVE_TRIGGERED]: CommentSaveTriggeredEvent;
     [CommentEventTypes.VISIBILITY_OPTION_CLICKED]: VisibilityOptionClickedEvent;
+    [CommentEventTypes.SUGGESTION_ACCEPTED]: SuggestionAcceptEvent;
+    [CommentEventTypes.SUGGESTION_REJECTED]: SuggestionRejectEvent;
 };
 export interface AddAttachmentEvent {
     annotationId: string;
@@ -145,6 +148,20 @@ export interface DeleteCommentAnnotationEvent {
     commentAnnotation: CommentAnnotation;
     metadata: VeltEventMetadata;
 }
+export interface SuggestionAcceptEvent {
+    annotationId: string;
+    commentAnnotation: CommentAnnotation;
+    metadata: VeltEventMetadata;
+    actionUser: User;
+}
+export interface SuggestionRejectEvent {
+    annotationId: string;
+    commentAnnotation: CommentAnnotation;
+    metadata: VeltEventMetadata;
+    actionUser: User;
+    /** Optional human-readable reason supplied at reject time. */
+    rejectReason?: string | null;
+}
 export interface GetCommentAnnotationsResponse {
     data: Record<string, CommentAnnotation[]> | null;
 }
@@ -181,6 +198,12 @@ export interface AddCommentEvent {
     comment: Comment;
     metadata: VeltEventMetadata;
 }
+export interface AddCommentDraftEvent {
+    annotationId: string;
+    commentAnnotation: CommentAnnotation;
+    comment: Comment;
+    metadata: VeltEventMetadata;
+}
 export interface CommentSavedEvent {
     annotationId: string;
     commentAnnotation: CommentAnnotation;
@@ -188,6 +211,7 @@ export interface CommentSavedEvent {
 }
 export interface CommentSaveTriggeredEvent {
     annotationId: string;
+    commentAnnotation: CommentAnnotation;
     metadata: VeltEventMetadata;
 }
 export interface UpdateCommentEvent {
@@ -332,6 +356,7 @@ export interface AttachmentDownloadClickedEvent {
 export interface VisibilityOptionClickedEvent {
     annotationId: string;
     commentAnnotation: CommentAnnotation;
-    visibility: 'public' | 'private';
+    visibility: CommentVisibilityOptionType;
+    users?: any[];
     metadata?: VeltEventMetadata;
 }

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

@@ -4,9 +4,9 @@ import { BaseMetadata } from "./base-metadata.data.model";
 import { CommentAnnotation } from "./comment-annotation.data.model";
 import { ResolverConfig, ResolverResponse } from "./resolver.data.model";
 export interface CommentAnnotationDataProvider {
-    get: (request: GetCommentResolverRequest) => Promise<ResolverResponse<Record<string, PartialCommentAnnotation>>>;
-    save: (request: SaveCommentResolverRequest) => Promise<ResolverResponse<undefined>>;
-    delete: (request: DeleteCommentResolverRequest) => Promise<ResolverResponse<undefined>>;
+    get?: (request: GetCommentResolverRequest) => Promise<ResolverResponse<Record<string, PartialCommentAnnotation>>>;
+    save?: (request: SaveCommentResolverRequest) => Promise<ResolverResponse<undefined>>;
+    delete?: (request: DeleteCommentResolverRequest) => Promise<ResolverResponse<undefined>>;
     config?: ResolverConfig;
 }
 export interface GetCommentResolverRequest {

package/app/models/data/comment-sidebar-config.model.d.ts

@@ -1,3 +1,4 @@
+import { CommentAccessMode } from "../../utils/enums";
 import { CommentAnnotation } from "./comment-annotation.data.model";
 import { UnreadCommentsMap } from "./comment-utils.data.model";
 import { CustomFilters } from "./custom-filter.data.model";
@@ -64,6 +65,7 @@ export declare class CommentSidebarFilters {
     priority?: string[];
     status?: string[];
     category?: string[];
+    accessModes?: CommentAccessMode[];
     version?: {
         id: string;
         name?: string;