@veltdev/sdk 5.0.2-beta.3 → 5.0.2-beta.31

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";
@@ -232,6 +233,10 @@ export declare class Snippyly {
     * Get the Autocomplete Object.
     */
    getAutocompleteElement: () => AutocompleteElement;
+   /**
+    * Get the Activity Element Object.
+    */
+   getActivityElement: () => ActivityElement;
    /**
     * Get the Area Object.
     */
@@ -360,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.
@@ -403,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,179 @@
+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 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/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

@@ -121,6 +121,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 +143,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,4 +1,4 @@
-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";
@@ -7,6 +7,7 @@ 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";
@@ -199,6 +200,13 @@ 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;
 }
 export declare class GhostComment {
     targetElement?: TargetElement | null;
@@ -241,7 +249,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;
@@ -181,6 +182,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 +195,7 @@ export interface CommentSavedEvent {
 }
 export interface CommentSaveTriggeredEvent {
     annotationId: string;
+    commentAnnotation: CommentAnnotation;
     metadata: VeltEventMetadata;
 }
 export interface UpdateCommentEvent {
@@ -332,6 +340,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;

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

@@ -51,6 +51,7 @@ export declare class Config {
     advancedQueriesDisabled?: boolean;
     /**
      * The domain of the API proxy.
+     * @deprecated Use `proxyConfig.apiHost` instead.
      */
     apiProxyDomain?: string;
     /**
@@ -61,6 +62,26 @@ export declare class Config {
      * Default: true
      */
     globalStyles?: boolean;
+    /**
+     * Configuration for routing all traffic through reverse proxies.
+     */
+    proxyConfig?: ProxyConfig;
+}
+export interface ProxyConfig {
+    /** Custom host for the Velt CDN (e.g., 'cdn-proxy.customer.com') */
+    cdnHost?: string;
+    /** Custom host for the Velt API (e.g., 'api-proxy.customer.com') */
+    apiHost?: string;
+    /** Custom host for Firestore (e.g., 'firestore-proxy.customer.com') */
+    v2DbHost?: string;
+    /** Custom host for Firebase RTDB (e.g., 'rtdb-proxy.customer.com'). Replaces the firebaseio.com domain in all RTDB URLs. */
+    v1DbHost?: string;
+    /** Custom host for Firebase Storage (e.g., 'storage-proxy.customer.com'). Replaces firebasestorage.googleapis.com. */
+    storageHost?: string;
+    /** Custom host for Firebase Auth (e.g., 'auth-proxy.customer.com'). Replaces identitytoolkit.googleapis.com and securetoken.googleapis.com. */
+    authHost?: string;
+    /** Force long-polling for Firestore and RTDB instead of WebSocket. Default: false (WebSocket). */
+    forceLongPolling?: boolean;
 }
 export interface ExtendedFirebaseOptions extends FirebaseOptions {
     storeDbId: string;
@@ -76,4 +97,9 @@ export interface DisableLogsConfig {
 }
 export interface GetProjectConfigResponse {
     isPrivateCommentsEnabled: boolean;
+    activityConfig?: ActivityConfig;
+}
+export interface ActivityConfig {
+    immutable: boolean;
+    isEnabled: boolean;
 }

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

@@ -7,6 +7,9 @@ export type CoreEventTypesMap = {
     [CoreEventTypes.COMMENT_RESOLVER]: CommentResolverEvent;
     [CoreEventTypes.ATTACHMENT_RESOLVER]: AttachmentResolverEvent;
     [CoreEventTypes.REACTION_RESOLVER]: ReactionResolverEvent;
+    [CoreEventTypes.RECORDER_RESOLVER]: RecorderResolverEvent;
+    [CoreEventTypes.NOTIFICATION_RESOLVER]: NotificationResolverEvent;
+    [CoreEventTypes.ACTIVITY_RESOLVER]: ActivityResolverEvent;
     [CoreEventTypes.VELT_BUTTON_CLICK]: VeltButtonClickEvent;
     [CoreEventTypes.USER_UPDATE]: UserUpdateEvent;
     [CoreEventTypes.DOCUMENT_INIT]: DocumentInitEvent;
@@ -147,6 +150,75 @@ export type ReactionResolverEventType = {
     REACTION_DELETE_RESULT: 'reactionDeleteResult';
     REACTION_DELETE_ERROR: 'reactionDeleteError';
 };
+export declare enum RecorderResolverSource {
+    RESOLVE_RECORDER_ANNOTATIONS = "resolveRecorderAnnotations",
+    SAVE_RECORDER_ANNOTATION = "saveRecorderAnnotation",
+    DELETE_RECORDER_ANNOTATION = "deleteRecorderAnnotation",
+    FORMAT_RESPONSE = "formatResponse",
+    INIT_DOCUMENTS = "initDocuments",
+    SET_DATA = "setData",
+    UPDATE_DATA = "updateData",
+    DELETE_DATA = "deleteData"
+}
+export declare enum RecorderResolverModuleName {
+    GET_RECORDER_ANNOTATIONS = "getRecorderAnnotations"
+}
+export type RecorderResolverEvent = BaseResolverEvent<RecorderResolverEventType, RecorderResolverSource, RecorderResolverModuleName>;
+export type RecorderResolverEventType = {
+    RECORDER_RESOLUTION_REQUEST_FORMED: 'recorderResolutionRequestFormed';
+    RECORDER_RESOLUTION_REQUEST_TRIGGERED: 'recorderResolutionRequestTriggered';
+    RECORDER_RESOLUTION_RESULT: 'recorderResolutionResult';
+    RECORDER_RESOLUTION_ERROR: 'recorderResolutionError';
+    RECORDER_RESOLUTION_RESULT_FROM_CACHE: 'recorderResolutionResultFromCache';
+    RECORDER_SAVE_REQUEST_FORMED: 'recorderSaveRequestFormed';
+    RECORDER_SAVE_REQUEST_TRIGGERED: 'recorderSaveRequestTriggered';
+    RECORDER_SAVE_RESULT: 'recorderSaveResult';
+    RECORDER_SAVE_ERROR: 'recorderSaveError';
+    RECORDER_DELETE_REQUEST_FORMED: 'recorderDeleteRequestFormed';
+    RECORDER_DELETE_REQUEST_TRIGGERED: 'recorderDeleteRequestTriggered';
+    RECORDER_DELETE_RESULT: 'recorderDeleteResult';
+    RECORDER_DELETE_ERROR: 'recorderDeleteError';
+};
+export declare enum NotificationResolverSource {
+    RESOLVE_NOTIFICATIONS = "resolveNotifications",
+    DELETE_NOTIFICATION = "deleteNotification",
+    DELETE_DATA = "deleteData",
+    FORMAT_RESPONSE = "formatResponse"
+}
+export declare enum NotificationResolverModuleName {
+    GET_NOTIFICATIONS = "getNotifications"
+}
+export type NotificationResolverEventType = {
+    NOTIFICATION_RESOLUTION_REQUEST_FORMED: 'notificationResolutionRequestFormed';
+    NOTIFICATION_RESOLUTION_REQUEST_TRIGGERED: 'notificationResolutionRequestTriggered';
+    NOTIFICATION_RESOLUTION_RESULT: 'notificationResolutionResult';
+    NOTIFICATION_RESOLUTION_ERROR: 'notificationResolutionError';
+    NOTIFICATION_DELETE_REQUEST_FORMED: 'notificationDeleteRequestFormed';
+    NOTIFICATION_DELETE_REQUEST_TRIGGERED: 'notificationDeleteRequestTriggered';
+    NOTIFICATION_DELETE_RESULT: 'notificationDeleteResult';
+    NOTIFICATION_DELETE_ERROR: 'notificationDeleteError';
+};
+export type NotificationResolverEvent = BaseResolverEvent<NotificationResolverEventType, NotificationResolverSource, NotificationResolverModuleName>;
+export declare enum ActivityResolverSource {
+    RESOLVE_ACTIVITIES = "resolveActivities",
+    SAVE_ACTIVITY = "saveActivity",
+    FORMAT_RESPONSE = "formatResponse"
+}
+export declare enum ActivityResolverModuleName {
+    GET_ACTIVITIES = "getActivities"
+}
+export type ActivityResolverEventType = {
+    ACTIVITY_RESOLUTION_REQUEST_FORMED: 'activityResolutionRequestFormed';
+    ACTIVITY_RESOLUTION_REQUEST_TRIGGERED: 'activityResolutionRequestTriggered';
+    ACTIVITY_RESOLUTION_RESULT: 'activityResolutionResult';
+    ACTIVITY_RESOLUTION_ERROR: 'activityResolutionError';
+    ACTIVITY_RESOLUTION_RESULT_FROM_CACHE: 'activityResolutionResultFromCache';
+    ACTIVITY_SAVE_REQUEST_FORMED: 'activitySaveRequestFormed';
+    ACTIVITY_SAVE_REQUEST_TRIGGERED: 'activitySaveRequestTriggered';
+    ACTIVITY_SAVE_RESULT: 'activitySaveResult';
+    ACTIVITY_SAVE_ERROR: 'activitySaveError';
+};
+export type ActivityResolverEvent = BaseResolverEvent<ActivityResolverEventType, ActivityResolverSource, ActivityResolverModuleName>;
 export type ErrorEvent = {
     event?: string;
     sourceMethod?: string;

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

@@ -58,3 +58,54 @@ export interface CrdtDeleteVersionQuery {
     id: string;
     versionId: string;
 }
+export interface CrdtPushMessageQuery {
+    id: string;
+    data: number[];
+    yjsClientId: number;
+    messageType?: 'sync' | 'awareness';
+    /** User-facing value for event emission only (not stored in database) */
+    eventData?: unknown;
+    /** Yjs data type: 'text' | 'map' | 'array' | 'xml' | 'xmltext' */
+    type?: string;
+    /** Content key used in Y.Doc shared types */
+    contentKey?: string;
+    /** Editor/library source: 'tiptap', 'plate', 'codemirror', etc. */
+    source?: string;
+}
+export interface CrdtOnMessageQuery {
+    id: string;
+    callback: (message: CrdtMessageData) => void;
+    afterTs?: number;
+}
+export interface CrdtMessageData {
+    data: number[];
+    yjsClientId: number;
+    timestamp: number;
+}
+export interface CrdtSnapshotData {
+    state?: Uint8Array | number[];
+    vector?: Uint8Array | number[];
+    timestamp?: number;
+}
+export interface CrdtGetSnapshotQuery {
+    id: string;
+}
+export interface CrdtSaveSnapshotQuery {
+    id: string;
+    state: Uint8Array | number[];
+    vector: Uint8Array | number[];
+    /** Yjs data type: 'text' | 'map' | 'array' | 'xml' | 'xmltext' */
+    type?: string;
+    /** Content key used in Y.Doc shared types */
+    contentKey?: string;
+    /** Editor/library source: 'tiptap', 'plate', 'codemirror', etc. */
+    source?: string;
+}
+export interface CrdtGetMessagesQuery {
+    id: string;
+    afterTs?: number;
+}
+export interface CrdtPruneMessagesQuery {
+    id: string;
+    beforeTs: number;
+}

package/app/models/data/document-paths.data.model.d.ts

@@ -6,6 +6,7 @@ export declare class DocumentPaths {
     folderId?: string;
     locationId?: string;
     allDocuments?: boolean;
+    optimisticPermissions?: boolean;
     veltFolderId?: string;
     folder?: string;
     /**

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

@@ -16,6 +16,8 @@ export interface SetDocumentsRequestOptions {
     locationId?: string;
     rootDocumentId?: string;
     context?: SetDocumentsContext;
+    debounceTime?: number;
+    optimisticPermissions?: boolean;
 }
 export interface UpdateDocumentsRequest<T = unknown> {
     organizationId?: string;

package/app/models/data/live-state-events.data.model.d.ts

@@ -5,12 +5,18 @@ export interface AccessRequestEvent {
     editor?: User;
     timestamp?: number;
     status?: string;
+    totalUsers?: number;
+    presenceSnippylyUserIds?: string[];
+    presenceClientUserIds?: string[];
 }
 export interface SEMEvent {
     viewer?: User;
     editor?: User;
     timestamp?: number;
     role?: string;
+    totalUsers?: number;
+    presenceSnippylyUserIds?: string[];
+    presenceClientUserIds?: string[];
 }
 export type LiveStateEventTypesMap = {
     [LiveStateSyncEventTypes.ACCESS_REQUESTED]: AccessRequestEvent;