@veltdev/sdk 4.0.0-beta.21 → 4.0.0-beta.23

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

@@ -26,219 +26,214 @@ import { DocumentMetadata } from "../models/data/document-metadata.model";
 import { ReactionElement } from "../models/element/reaction-element.model";
 import { VeltEventMetadata } from "../models/data/event-metadata.data.model";
 import { CoreEventTypesMap } from "../models/data/core-events.data.model";
-import { Document, SetDocumentsRequestOptions } from "../models/data/document.data.model";
+import { Document, SetDocumentsRequestOptions, FetchDocumentsRequest, FetchFoldersRequest } from "../models/data/document.data.model";
+import { FetchDocumentsResponse, FetchFoldersResponse } from "../models/data/document-events.data.model";
 import { UserDataProvider } from "../models/data/user-resolver.data.model";
+
 export declare class Snippyly {
-  constructor();
-  initConfig: (apiKey: string, config?: Config) => void;
-  identify: (user: User, userOptions?: UserOptions) => Promise<unknown>;
-  /**
-   * Tell us who the currently logged in user is.
-   *
-   * Call whenever the user is updated: signs in, signs out, signs up etc.
-   * @deprecated This method is deprecated and will be removed in next release.
-   */
-  updateUser: (user: User) => void;
-  /**
-   * Tell us the unique ID of the current document/resource on which you want to enable collaboration.
-   * @param id unique document ID
-   * @param documentMetadata Document Metadata
-   */
-  setDocument: (id: string, documentMetadata?: DocumentMetadata) => void;
-  /**
-   * Tell us the unique ID of the current document/resource on which you want to enable collaboration.
-   * @param id unique document ID
-   */
-  setDocumentId: (id: string) => void;
-  /**
-   * To set multiple documents
-   */
-  setDocuments: (documents: Document[], options?: SetDocumentsRequestOptions) => void;
-  /**
-   * To unset the document id
-   */
-  unsetDocumentId: () => void;
-  /**
-   * To unset the documents
-   */
-  unsetDocuments: () => void;
-  /**
-   * To set the user data provider.
-   */
-  setUserDataProvider: (userDataProvider: UserDataProvider) => void;
-  /**
-   * Get Document ID
-   */
-  getDocumentId: () => string;
-  /**
-   * Tell us the custom params of the current document/resource to identify sub document inside a document.
-   * @param params Document Params
-   * @deprecated This method is depercated and will be removed in next release. Use `setLocation` method instead.
-   */
-  setDocumentParams: (params: Location) => void;
-  /**
-   * Tell us the custom params of the current document/resource to identify sub document inside a document.
-   * @param params Location
-   * @param appendLocation Append location to existing location
-   */
-  setLocation: (params: Location, appendLocation?: boolean) => void;
-  /**
-   * To remove document params from a User
-   * @deprecated This method is depercated and will be removed in next release. Use `removeLocation` method instead.
-   */
-  removeDocumentParams: () => void;
-  /**
-     * To remove location from a User
-     * @param location Location
-     */
-  removeLocation: (location?: Location) => void;
-  /**
-   * To exclude data of specific location ids
-   * @param ids Location Ids
-   */
-  excludeLocationIds: (ids: string[]) => void;
-  /**
-   * Tell us the about the scrollable document ids to keep track on its scroll changes
-   * @param ids scrollable elements ids
-   */
-  setScrollableElementsIds: (ids: string[]) => void;
-  /**
-   * To remove document params from a User
-   */
-  removeScrollableElementsIds: () => void;
-  /**
-   * Get the Presence Element Object to access the raw presence data.
-   *
-   * This is for Pros who don’t want to use Snippyly Presence web component and want to design their own UI.
-   */
-  getPresenceElement: () => PresenceElement;
-  /**
-   * Get the Cursor Element Object to access the raw cursor data.
-   *
-   * This is for Pros who don’t want to use Snippyly Presence web component and want to design their own UI.
-   */
-  getCursorElement: () => CursorElement;
-  /**
-   * Get the Comment Element Object to access the raw comment data.
-   *
-   * This is for Pros who don’t want to use Snippyly Comment web component and want to design their own UI.
-   */
-  getCommentElement: () => CommentElement;
-  /**
-   * Get the Tag Pin Annotation Object to access the raw tag data.
-   *
-   * This is for Pros who don’t want to use Snippyly Tag web component and want to design their own UI.
-   */
-  getTagElement: () => TagElement;
-  /**
-   * Get the Selection Object to enable/disable the feature.
-   */
-  getSelectionElement: () => SelectionElement;
-  /**
-   * Get the Recorder Object.
-   */
-  getRecorderElement: () => RecorderElement;
-  /**
-   * Get the Contact Object.
-   */
-  getContactElement: () => ContactElement;
-  /**
-   * Get the Rewriter Object.
-   */
-  getRewriterElement: () => RewriterElement;
-  /**
-   * Get the Huddle element.
-   */
-  getHuddleElement: () => HuddleElement;
-  /**
-   * Get the LiveStateSync Object.
-   */
-  getLiveStateSyncElement: () => LiveStateSyncElement;
-  /**
-   * Get the Arrow Object.
-   */
-  getArrowElement: () => ArrowElement;
-  /**
-   * Get the Views Object.
-   */
-  getViewsElement: () => ViewsElement;
-  /**
-   * Get the Notification Object.
-   */
-  getNotificationElement: () => NotificationElement;
-  /**
-   * Get the Autocomplete Object.
-   */
-  getAutocompleteElement: () => AutocompleteElement;
-  /**
-   * Get the Area Object.
-   */
-  getAreaElement: () => AreaElement;
-  /**
-   * Get the Area Object.
-   */
-  getReactionElement: () => ReactionElement;
-  /**
-   * Get the metadata of the current resource.
-   */
-  getMetadata: () => Promise<VeltEventMetadata | null>;
-  /**
-   * To signout a user
-   */
-  signOutUser: () => any;
-  /**
-   * Provide a list of features to disable.
-   * Provide an empty array to enable all the features.
-   * @param features List of features
-   */
-  disableFeatures: (features: Array<FeatureType>) => void;
-  /**
+   constructor();
+   initConfig: (apiKey: string, config?: Config) => void;
+   identify: (user: User, userOptions?: UserOptions) => Promise<unknown>;
+   /**
+    * Tell us who the currently logged in user is.
+    *
+    * Call whenever the user is updated: signs in, signs out, signs up etc.
+    * @deprecated This method is deprecated.
+    */
+   updateUser: (user: User) => void;
+   /**
+    * Tell us the unique ID of the current document/resource on which you want to enable collaboration.
+    * @param id unique document ID
+    * @param documentMetadata Document Metadata
+    */
+   setDocument: (id: string, documentMetadata?: DocumentMetadata) => void;
+   /**
+    * Tell us the unique ID of the current document/resource on which you want to enable collaboration.
+    * @param id unique document ID
+    * @deprecated This method is deprecated. Use `setDocuments` method instead.
+    */
+   setDocumentId: (id: string) => void;
+   /**
+    * To set multiple documents
+    */
+   setDocuments: (documents: Document[], options?: SetDocumentsRequestOptions) => void;
+   /**
+    * To unset the document id
+    * @deprecated This method is deprecated. Use `unsetDocuments` method instead.
+    */
+   unsetDocumentId: () => void;
+   /**
+    * To unset the documents
+    */
+   unsetDocuments: () => void;
+   /**
+    * To fetch documents
+    */
+   fetchDocuments: (options?: FetchDocumentsRequest) => Promise<FetchDocumentsResponse>;
+   /**
+    * To fetch folders
+    */
+   fetchFolders: (options?: FetchFoldersRequest) => Promise<FetchFoldersResponse>;
+   /**
+    * To set the user data provider.
+    */
+   setUserDataProvider: (userDataProvider: UserDataProvider) => void;
+   /**
+    * Get Document ID
+    */
+   getDocumentId: () => string;
+   /**
+    * Tell us the custom params of the current document/resource to identify sub document inside a document.
+    * @param params Location
+    * @param appendLocation Append location to existing location
+    */
+   setLocation: (params: Location, appendLocation?: boolean) => void;
+   /**
+      * To remove location from a User
+      * @param location Location
+      */
+   removeLocation: (location?: Location) => void;
+   /**
+    * To exclude data of specific location ids
+    * @param ids Location Ids
+    */
+   excludeLocationIds: (ids: string[]) => void;
+   /**
+    * Tell us the about the scrollable document ids to keep track on its scroll changes
+    * @param ids scrollable elements ids
+    */
+   setScrollableElementsIds: (ids: string[]) => void;
+   /**
+    * To remove document params from a User
+    */
+   removeScrollableElementsIds: () => void;
+   /**
+    * Get the Presence Element Object to access the raw presence data.
+    *
+    * This is for Pros who don’t want to use Snippyly Presence web component and want to design their own UI.
+    */
+   getPresenceElement: () => PresenceElement;
+   /**
+    * Get the Cursor Element Object to access the raw cursor data.
+    *
+    * This is for Pros who don’t want to use Snippyly Presence web component and want to design their own UI.
+    */
+   getCursorElement: () => CursorElement;
+   /**
+    * Get the Comment Element Object to access the raw comment data.
+    *
+    * This is for Pros who don’t want to use Snippyly Comment web component and want to design their own UI.
+    */
+   getCommentElement: () => CommentElement;
+   /**
+    * Get the Tag Pin Annotation Object to access the raw tag data.
+    *
+    * This is for Pros who don’t want to use Snippyly Tag web component and want to design their own UI.
+    */
+   getTagElement: () => TagElement;
+   /**
+    * Get the Selection Object to enable/disable the feature.
+    */
+   getSelectionElement: () => SelectionElement;
+   /**
+    * Get the Recorder Object.
+    */
+   getRecorderElement: () => RecorderElement;
+   /**
+    * Get the Contact Object.
+    */
+   getContactElement: () => ContactElement;
+   /**
+    * Get the Rewriter Object.
+    */
+   getRewriterElement: () => RewriterElement;
+   /**
+    * Get the Huddle element.
+    */
+   getHuddleElement: () => HuddleElement;
+   /**
+    * Get the LiveStateSync Object.
+    */
+   getLiveStateSyncElement: () => LiveStateSyncElement;
+   /**
+    * Get the Arrow Object.
+    */
+   getArrowElement: () => ArrowElement;
+   /**
+    * Get the Views Object.
+    */
+   getViewsElement: () => ViewsElement;
+   /**
+    * Get the Notification Object.
+    */
+   getNotificationElement: () => NotificationElement;
+   /**
+    * Get the Autocomplete Object.
+    */
+   getAutocompleteElement: () => AutocompleteElement;
+   /**
+    * Get the Area Object.
+    */
+   getAreaElement: () => AreaElement;
+   /**
+    * Get the Area Object.
+    */
+   getReactionElement: () => ReactionElement;
+   /**
+    * Get the metadata of the current resource.
+    */
+   getMetadata: () => Promise<VeltEventMetadata | null>;
+   /**
+    * To signout a user
+    */
+   signOutUser: () => any;
+   /**
+    * Provide a list of features to disable.
+    * Provide an empty array to enable all the features.
+    * @param features List of features
+    */
+   disableFeatures: (features: Array<FeatureType>) => void;
+   /**
    * Add location to show comments, tags, recorders etc. for provided location also.
    * @param location Location object
    * @deprecated This method is deprecated and will be removed in next release. Use `setLocation` method with `appendLocation: true` instead.
    */
-  addLocation: (location: any) => any;
-  /**
-   * To set the dark mode of Velt components.
-   * @param value {boolean} true/false
-   */
-  setDarkMode: (darkMode: boolean) => void;
-
-  /**
-   * To check if user allowed in provided document or not.
-   */
-  isUserAllowed$: () => Observable<boolean>;
+   addLocation: (location: any) => any;
+   /**
+    * To set the dark mode of Velt components.
+    * @param value {boolean} true/false
+    */
+   setDarkMode: (darkMode: boolean) => void;
 
-  /**
-   * To get user role in provided document.
-   */
-  getUserRole$: () => Observable<string | null>;
+   /**
+    * To check if user allowed in provided document or not.
+    */
+   isUserAllowed$: () => Observable<boolean>;
 
-  /**
-   * To check if plan is expired or not.
-   */
-  isPlanExpired$: () => Observable<boolean>;
+   /**
+    * To get user.
+    */
+   getUser: () => User | null;
 
-  /**
-   * To get if the Velt is initialized or not.
-   * @returns Observable<boolean | undefined>
-   */
-  getVeltInitState: () => Observable<boolean | undefined>;
+   /**
+    * To get user role in provided document.
+    */
+   getUserRole$: () => Observable<string | null>;
 
-  /**
-   * To invite list of users to the document.
-   * @param documentUsers List of document users
-   */
-  inviteUsers: (documentUsers: Array<DocumentUser>) => void;
+   /**
+    * To check if plan is expired or not.
+    */
+   isPlanExpired$: () => Observable<boolean>;
 
-  /**
-   * To remove snippyly specific content from provided html content.
-   */
-  removeSnippylyContent: (htmlContent: string) => string;
+   /**
+    * To get if the Velt is initialized or not.
+    * @returns Observable<boolean | undefined>
+    */
+   getVeltInitState: () => Observable<boolean | undefined>;
 
-  /**
-   * To remove velt specific content from provided html content.
-   */
+   /**
+    * To remove velt specific content from provided html content.
+    */
    removeVeltContent: (htmlContent: string) => string;
 
    /**
@@ -272,10 +267,11 @@ export declare class Snippyly {
    /**
     * To update user contact list.
     */
-   updateContactList: (userContacts: UserContact[], config?: {merge: boolean}) => void;
+   updateContactList: (userContacts: UserContact[], config?: { merge: boolean }) => void;
 
    /**
     * To get document metadata.
+    * @deprecated This method is deprecated. Use `fetchDocuments` method instead.
     */
    getDocumentMetadata: () => Observable<DocumentMetadata | null>;
 
@@ -283,4 +279,14 @@ export declare class Snippyly {
     * To subscribe to core actions
     */
    on: <T extends keyof CoreEventTypesMap>(action: T) => Observable<CoreEventTypesMap[T]>;
-}
+
+   /**
+   * To set the ui state.
+   */
+   setUiState: (uiState: { [key: string]: any }) => void;
+
+   /**
+    * To get the ui state.
+    */
+   getUiState: () => Observable<{ [key: string]: any }>;
+}

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

@@ -5,9 +5,7 @@ import { AddAttachmentResponse } from "./comment-actions.data.model";
 import { CommentAnnotation, UpdateContextConfig } from "./comment-annotation.data.model";
 import { Comment } from "./comment.data.model";
 import { CustomPriority, CustomStatus } from "./custom-filter.data.model";
-import { DocumentMetadata } from "./document-metadata.model";
 import { VeltEventMetadata } from "./event-metadata.data.model";
-import { FolderMetadata } from "./folder-metadata.model";
 import { Location } from "./location.model";
 import { ReactionAnnotation } from "./reaction-annotation.data.model";
 import { RecordedData } from "./recorder.model";
@@ -79,6 +77,8 @@ export type CommentEventTypesMap = {
     [CommentEventTypes.TOGGLE_REACTION]: ToggleReactionEvent;
     [CommentEventTypes.COMMENT_SIDEBAR_DATA_INIT]: CommentSidebarDataInitEvent;
     [CommentEventTypes.COMMENT_SIDEBAR_DATA_UPDATE]: CommentSidebarDataUpdateEvent;
+    [CommentEventTypes.AUTOCOMPLETE_SEARCH]: AutocompleteSearchEvent;
+    [CommentEventTypes.COMPOSER_CLICKED]: ComposerClickedEvent;
 };
 export interface AddAttachmentEvent {
     annotationId: string;
@@ -134,14 +134,6 @@ export interface GetCommentAnnotationsResponse {
 export interface FetchCommentAnnotationsResponse extends GetCommentAnnotationsResponse {
     nextPageToken: string;
 }
-export interface FetchDocumentsResponse {
-    data: Record<string, DocumentMetadata[]> | null;
-    nextPageToken: string;
-}
-export interface FetchFoldersResponse {
-    data: Record<string, FolderMetadata[]> | null;
-    nextPageToken: string;
-}
 export interface GetCommentAnnotationsCountResponse {
     data: Record<string, CommentAnnotationsCount> | null;
 }
@@ -248,3 +240,13 @@ export interface CommentSidebarDataInitEvent extends VeltButtonClickEvent {
 }
 export interface CommentSidebarDataUpdateEvent extends VeltButtonClickEvent {
 }
+export interface AutocompleteSearchEvent {
+    event: KeyboardEvent | InputEvent | Event;
+    searchText: string;
+    type?: 'contact' | 'custom' | 'group';
+    metadata?: VeltEventMetadata;
+}
+export interface ComposerClickedEvent {
+    commentAnnotation?: CommentAnnotation;
+    metadata?: VeltEventMetadata;
+}

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

@@ -0,0 +1,10 @@
+import { DocumentMetadata } from "./document-metadata.model";
+import { FolderMetadata } from "./folder-metadata.model";
+export interface FetchDocumentsResponse {
+    data: Record<string, DocumentMetadata> | null;
+    nextPageToken: string;
+}
+export interface FetchFoldersResponse {
+    data: Record<string, FolderMetadata> | null;
+    nextPageToken: string;
+}

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

@@ -1073,6 +1073,16 @@ export declare class CommentElement {
    */
   public disableReadOnly: () => void;
 
+  /**
+   * To enable custom autocomplete search
+   */
+  public enableCustomAutocompleteSearch: () => void;
+
+  /**
+   * To disable custom autocomplete search
+   */
+  public disableCustomAutocompleteSearch: () => void;
+
   constructor();
   /**
    * Subscribe to comments on the current document.
@@ -2127,4 +2137,14 @@ export declare class CommentElement {
    * To disable read only
    */
   private _disableReadOnly;
+
+  /**
+   * To enable custom autocomplete search
+   */
+  private _enableCustomAutocompleteSearch;
+
+  /**
+   * To disable custom autocomplete search
+   */
+  private _disableCustomAutocompleteSearch;
 }

package/app/utils/enums.d.ts

@@ -41,6 +41,8 @@ export declare const CommentEventTypes: {
     readonly TOGGLE_REACTION: "toggleReaction";
     readonly COMMENT_SIDEBAR_DATA_INIT: "commentSidebarDataInit";
     readonly COMMENT_SIDEBAR_DATA_UPDATE: "commentSidebarDataUpdate";
+    readonly AUTOCOMPLETE_SEARCH: "autocompleteSearch";
+    readonly COMPOSER_CLICKED: "composerClicked";
 };
 export declare const RecorderEventTypes: {
     readonly TRANSCRIPTION_DONE: "transcriptionDone";

package/models.d.ts

@@ -18,6 +18,7 @@ export * from './app/models/data/custom-css.data.model';
 export * from './app/models/data/custom-chip-dropdown.data.model';
 export * from './app/models/data/device-info.model';
 export * from './app/models/data/document.data.model';
+export * from './app/models/data/document-events.data.model';
 export * from './app/models/data/document-iam.data.model';
 export * from './app/models/data/document-metadata.model';
 export * from './app/models/data/document-paths.data.model';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@veltdev/sdk",
-    "version": "4.0.0-beta.21",
+    "version": "4.0.0-beta.23",
     "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": [