@wix/auto_sdk_comments_comments 1.0.0 → 1.0.2

package/build/es/src/comments-v2-comment-comments.universal.d.ts

@@ -6,6 +6,7 @@
 export interface Comment {
     /**
      * Comment ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
@@ -28,13 +29,19 @@ export interface Comment {
      * @readonly
      */
     _updatedDate?: Date | null;
-    /** ID of the app that the comment is added to. */
+    /**
+     * ID of the app that the comment is added to.
+     * @format GUID
+     * @immutable
+     */
     appId?: string | null;
     /**
      * ID of the specific context the comment is in response to.
      *
      * Within some Wix apps, the `contextId` will be the same as the `resourceId`. For example in Wix Forum,
      * the `forumPostId` is used as both the `contextId` and the `resourceId`.
+     * @immutable
+     * @maxLength 128
      */
     contextId?: string | null;
     /**
@@ -42,11 +49,16 @@ export interface Comment {
      *
      * Within some Wix apps, the `resourceId` will be the same as the `contextId`. For example in Wix Forum,
      * the `forumPostId` is used as both the `resourceId` and the `contextId`.
+     * @immutable
+     * @maxLength 128
      */
     resourceId?: string | null;
     /** Published comment content. */
     content?: CommentContent;
-    /** Comment's author. */
+    /**
+     * Comment's author.
+     * @immutable
+     */
     author?: CommentAuthor;
     /**
      * Parent comment information.
@@ -83,7 +95,10 @@ export interface Comment {
     reactionSummary?: CommentReactionSummary;
     /** Whether the comment is marked. */
     marked?: boolean;
-    /** Date and time when the comment was actually created. */
+    /**
+     * Date and time when the comment was actually created.
+     * @immutable
+     */
     commentDate?: Date | null;
     /**
      * Whether the comment has the updated content.
@@ -105,9 +120,13 @@ export interface CommentContent {
      * People to tag with this comment.
      *
      * People can include users, members, visitors, or groups.
+     * @maxSize 10
      */
     mentions?: Mention[];
-    /** Content attachments. */
+    /**
+     * Content attachments.
+     * @maxSize 10
+     */
     attachments?: Attachment[];
 }
 export interface RichContent {
@@ -708,11 +727,20 @@ export interface GIFData {
     gifType?: GIFType;
 }
 export interface GIF {
-    /** GIF format URL. */
+    /**
+     * GIF format URL.
+     * @format WEB_URL
+     */
     gif?: string | null;
-    /** MP4 format URL. */
+    /**
+     * MP4 format URL.
+     * @format WEB_URL
+     */
     mp4?: string | null;
-    /** Thumbnail URL. */
+    /**
+     * Thumbnail URL.
+     * @format WEB_URL
+     */
     still?: string | null;
 }
 export declare enum GIFType {
@@ -778,6 +806,25 @@ export interface ImageData {
     caption?: string | null;
     /** Sets whether the image's download button is disabled. Defaults to `false`. */
     disableDownload?: boolean | null;
+    /** Sets whether the image is decorative and does not need an explanation. Defaults to `false`. */
+    decorative?: boolean | null;
+    /** Styling for the image. */
+    styles?: ImageDataStyles;
+}
+export interface StylesBorder {
+    /** Border width in pixels. */
+    width?: number | null;
+    /**
+     * Border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
+    color?: string | null;
+    /** Border radius in pixels. */
+    radius?: number | null;
+}
+export interface ImageDataStyles {
+    /** Border attributes. */
+    border?: StylesBorder;
 }
 export interface LinkPreviewData {
     /** Styling for the link preview's container. */
@@ -924,13 +971,22 @@ export declare enum BackgroundType {
 export interface Gradient {
     /** The gradient angle in degrees. */
     angle?: number | null;
-    /** The start color as a hexademical value. */
+    /**
+     * The start color as a hexademical value.
+     * @format COLOR_HEX
+     */
     startColor?: string | null;
-    /** The end color as a hexademical value. */
+    /**
+     * The end color as a hexademical value.
+     * @format COLOR_HEX
+     */
     lastColor?: string | null;
 }
 export interface Background extends BackgroundBackgroundOneOf {
-    /** The background color as a hexademical value. */
+    /**
+     * The background color as a hexademical value.
+     * @format COLOR_HEX
+     */
     color?: string | null;
     /** An image to use for the background. */
     image?: Media;
@@ -941,7 +997,10 @@ export interface Background extends BackgroundBackgroundOneOf {
 }
 /** @oneof */
 export interface BackgroundBackgroundOneOf {
-    /** The background color as a hexademical value. */
+    /**
+     * The background color as a hexademical value.
+     * @format COLOR_HEX
+     */
     color?: string | null;
     /** An image to use for the background. */
     image?: Media;
@@ -1253,17 +1312,32 @@ export declare enum VerticalAlignment {
 export interface CellStyle {
     /** Vertical alignment for the cell's text. */
     verticalAlignment?: VerticalAlignment;
-    /** Cell background color as a hexadecimal value. */
+    /**
+     * Cell background color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     backgroundColor?: string | null;
 }
 export interface BorderColors {
-    /** Left border color as a hexadecimal value. */
+    /**
+     * Left border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     left?: string | null;
-    /** Right border color as a hexadecimal value. */
+    /**
+     * Right border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     right?: string | null;
-    /** Top border color as a hexadecimal value. */
+    /**
+     * Top border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     top?: string | null;
-    /** Bottom border color as a hexadecimal value. */
+    /**
+     * Bottom border color as a hexadecimal value.
+     * @format COLOR_HEX
+     */
     bottom?: string | null;
 }
 /**
@@ -1372,24 +1446,48 @@ export interface TextNodeStyle {
     lineHeight?: string | null;
 }
 export interface Mention extends MentionIdentityOneOf {
-    /** Wix user ID. */
+    /**
+     * Wix user ID.
+     * @format GUID
+     */
     userId?: string | null;
-    /** Member ID. See the Members API for more details. */
+    /**
+     * Member ID. See the Members API for more details.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Visitor ID. */
+    /**
+     * Visitor ID.
+     * @format GUID
+     */
     visitorId?: string | null;
-    /** Group ID. See the Groups API for more details. */
+    /**
+     * Group ID. See the Groups API for more details.
+     * @format GUID
+     */
     groupId?: string | null;
 }
 /** @oneof */
 export interface MentionIdentityOneOf {
-    /** Wix user ID. */
+    /**
+     * Wix user ID.
+     * @format GUID
+     */
     userId?: string | null;
-    /** Member ID. See the Members API for more details. */
+    /**
+     * Member ID. See the Members API for more details.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Visitor ID. */
+    /**
+     * Visitor ID.
+     * @format GUID
+     */
     visitorId?: string | null;
-    /** Group ID. See the Groups API for more details. */
+    /**
+     * Group ID. See the Groups API for more details.
+     * @format GUID
+     */
     groupId?: string | null;
 }
 export interface Attachment extends AttachmentMediaOneOf {
@@ -1401,7 +1499,10 @@ export interface Attachment extends AttachmentMediaOneOf {
     audio?: string;
     /** Information about the document. */
     document?: string;
-    /** Mime type of attachment. */
+    /**
+     * Mime type of attachment.
+     * @maxLength 3000
+     */
     mimeType?: string | null;
 }
 /** @oneof */
@@ -1455,45 +1556,91 @@ export interface VideoResolution {
     assetKey?: string | null;
 }
 export interface ContentAuthor extends ContentAuthorAuthorOneOf {
-    /** Wix user ID. */
+    /**
+     * Wix user ID.
+     * @format GUID
+     */
     userId?: string | null;
-    /** Member ID. See the Members API for more details. */
+    /**
+     * Member ID. See the Members API for more details.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Visitor ID. */
+    /**
+     * Visitor ID.
+     * @format GUID
+     */
     visitorId?: string | null;
-    /** Application ID. For more information, see [Authenticate as an App Instance](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/authenticate-as-an-app-instance). */
+    /**
+     * Application ID. For more information, see [Authenticate as an App Instance](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/authenticate-as-an-app-instance).
+     * @format GUID
+     */
     appId?: string | null;
 }
 /** @oneof */
 export interface ContentAuthorAuthorOneOf {
-    /** Wix user ID. */
+    /**
+     * Wix user ID.
+     * @format GUID
+     */
     userId?: string | null;
-    /** Member ID. See the Members API for more details. */
+    /**
+     * Member ID. See the Members API for more details.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Visitor ID. */
+    /**
+     * Visitor ID.
+     * @format GUID
+     */
     visitorId?: string | null;
-    /** Application ID. For more information, see [Authenticate as an App Instance](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/authenticate-as-an-app-instance). */
+    /**
+     * Application ID. For more information, see [Authenticate as an App Instance](https://dev.wix.com/docs/build-apps/develop-your-app/access/authentication/authenticate-as-an-app-instance).
+     * @format GUID
+     */
     appId?: string | null;
 }
 export interface CommentAuthor extends CommentAuthorIdentityOneOf {
-    /** Wix user ID. */
+    /**
+     * Wix user ID.
+     * @format GUID
+     */
     userId?: string | null;
-    /** Member ID. See the Members API for more details. */
+    /**
+     * Member ID. See the Members API for more details.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Visitor ID. */
+    /**
+     * Visitor ID.
+     * @format GUID
+     */
     visitorId?: string | null;
 }
 /** @oneof */
 export interface CommentAuthorIdentityOneOf {
-    /** Wix user ID. */
+    /**
+     * Wix user ID.
+     * @format GUID
+     */
     userId?: string | null;
-    /** Member ID. See the Members API for more details. */
+    /**
+     * Member ID. See the Members API for more details.
+     * @format GUID
+     */
     memberId?: string | null;
-    /** Visitor ID. */
+    /**
+     * Visitor ID.
+     * @format GUID
+     */
     visitorId?: string | null;
 }
 export interface ParentComment {
-    /** Comment ID of the parent comment. */
+    /**
+     * Comment ID of the parent comment.
+     * @format GUID
+     * @immutable
+     */
     _id?: string | null;
     /**
      * Author of the parent comment.
@@ -1550,9 +1697,15 @@ export interface UpdateInternalDocumentsEvent extends UpdateInternalDocumentsEve
     versionedUpdate?: VersionedDocumentUpdateOperation;
     /** delete by document ids with versioning */
     versionedDeleteByIds?: VersionedDeleteByIdsOperation;
-    /** type of the documents */
+    /**
+     * type of the documents
+     * @minLength 2
+     */
     documentType?: string;
-    /** language of the documents (mandatory) */
+    /**
+     * language of the documents (mandatory)
+     * @minLength 2
+     */
     language?: string | null;
     /**
      * one or more search documents
@@ -1679,7 +1832,10 @@ export interface ResourceCommentCountChanged {
     publishedCommentCount?: number;
 }
 export interface GetCommentRequest {
-    /** ID of the comment to retrieve. */
+    /**
+     * ID of the comment to retrieve.
+     * @format GUID
+     */
     commentId: string;
 }
 export interface GetCommentResponse {
@@ -1704,7 +1860,10 @@ export interface CommentContentChanged {
     currentContent?: CommentContent;
 }
 export interface DeleteCommentRequest {
-    /** ID of the comment to delete. */
+    /**
+     * ID of the comment to delete.
+     * @format GUID
+     */
     commentId: string;
 }
 export interface DeleteCommentResponse {
@@ -1713,7 +1872,10 @@ export interface CommentDeleted {
     comment?: Comment;
 }
 export interface ModerateDraftContentRequest {
-    /** ID of the comment to moderate. */
+    /**
+     * ID of the comment to moderate.
+     * @format GUID
+     */
     commentId: string;
     /**
      * Revision number, which increments by `1` each time the comment is updated.
@@ -1738,7 +1900,10 @@ export interface CommentHidden {
     comment?: Comment;
 }
 export interface QueryCommentsRequest {
-    /** App ID to query comments for. */
+    /**
+     * App ID to query comments for.
+     * @format GUID
+     */
     appId: string;
     /** Query options. */
     query: CursorQuery;
@@ -1760,6 +1925,7 @@ export interface CursorQuery extends CursorQueryPagingMethodOneOf {
      * Sort object.
      *
      * Learn more about the [sort section](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#the-sort-section).
+     * @maxSize 5
      */
     sort?: Sorting[];
 }
@@ -1773,7 +1939,10 @@ export interface CursorQueryPagingMethodOneOf {
     cursorPaging?: CursorPaging;
 }
 export interface Sorting {
-    /** Name of the field to sort by. */
+    /**
+     * Name of the field to sort by.
+     * @maxLength 512
+     */
     fieldName?: string;
     /** Sort order. */
     order?: SortOrder;
@@ -1783,13 +1952,17 @@ export declare enum SortOrder {
     DESC = "DESC"
 }
 export interface CursorPaging {
-    /** Maximum number of items to return in the results. */
+    /**
+     * Maximum number of items to return in the results.
+     * @max 100
+     */
     limit?: number | null;
     /**
      * Pointer to the next or previous page in the list of results.
      *
      * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
      * Not relevant for the first request.
+     * @maxLength 16000
      */
     cursor?: string | null;
 }
@@ -1813,13 +1986,22 @@ export interface CursorPagingMetadata {
     hasNext?: boolean | null;
 }
 export interface Cursors {
-    /** Cursor string pointing to the next page in the list of results. */
+    /**
+     * Cursor string pointing to the next page in the list of results.
+     * @maxLength 16000
+     */
     next?: string | null;
-    /** Cursor pointing to the previous page in the list of results. */
+    /**
+     * Cursor pointing to the previous page in the list of results.
+     * @maxLength 16000
+     */
     prev?: string | null;
 }
 export interface MarkCommentRequest {
-    /** ID of the comment to mark. */
+    /**
+     * ID of the comment to mark.
+     * @format GUID
+     */
     commentId: string;
 }
 export interface MarkCommentResponse {
@@ -1830,7 +2012,10 @@ export interface CommentMarked {
     comment?: Comment;
 }
 export interface UnmarkCommentRequest {
-    /** ID of the comment to unmark. */
+    /**
+     * ID of the comment to unmark.
+     * @format GUID
+     */
     commentId: string;
 }
 export interface UnmarkCommentResponse {
@@ -1841,7 +2026,10 @@ export interface CommentUnmarked {
     comment?: Comment;
 }
 export interface HideCommentRequest {
-    /** ID of the comment to hide. */
+    /**
+     * ID of the comment to hide.
+     * @format GUID
+     */
     commentId: string;
 }
 export interface HideCommentResponse {
@@ -1849,7 +2037,10 @@ export interface HideCommentResponse {
     comment?: Comment;
 }
 export interface PublishCommentRequest {
-    /** ID of the comment to publish. */
+    /**
+     * ID of the comment to publish.
+     * @format GUID
+     */
     commentId: string;
 }
 export interface PublishCommentResponse {
@@ -1858,7 +2049,10 @@ export interface PublishCommentResponse {
 }
 /** Count comments options. */
 export interface CountCommentsRequest {
-    /** App ID to count the comments of. */
+    /**
+     * App ID to count the comments of.
+     * @format GUID
+     */
     appId?: string;
     /** Filter to identify the comments that need to be counted. */
     filter?: Record<string, any> | null;
@@ -1868,20 +2062,28 @@ export interface CountCommentsResponse {
     count?: number;
 }
 export interface ListCommentsByResourceRequest {
-    /** ID of the app from which the comments are listed. */
+    /**
+     * ID of the app from which the comments are listed.
+     * @format GUID
+     */
     appId: string;
     /**
      * ID of the specific context the comment is in response to.
      *
      * Within some Wix apps, the `contextId` will be the same as the `resourceId`. For example in Wix Forum, the `forumPostId` is used as both the `contextId` and the `resourceId`.
+     * @maxLength 128
      */
     contextId: string;
-    /** Reserved for internal use. */
+    /**
+     * Reserved for internal use.
+     * @maxLength 128
+     */
     contextType?: string;
     /**
      * ID of the specific resource that the comment is in response to.
      *
      * Within some Wix apps, the `resourceId` will be the same as the `contextId`. For example in Wix Forum, the `forumPostId` is used as both the `resourceId` and the `contextId`.
+     * @maxLength 128
      */
     resourceId: string;
     /** Comment sort. Is ignored if `cursorPaging.cursor` is defined. */
@@ -1944,9 +2146,16 @@ export declare enum ReplySortOrder {
 export interface ListCommentsByResourceCursorPaging {
     /** Pointer to the next or previous page in the list of results. */
     cursor?: string | null;
-    /** Number of items to return. */
+    /**
+     * Number of items to return.
+     * @min 1
+     * @max 100
+     */
     limit?: number | null;
-    /** Maximum number of replies in a response. Only applicable to parent comments. */
+    /**
+     * Maximum number of replies in a response. Only applicable to parent comments.
+     * @max 100
+     */
     repliesLimit?: number | null;
 }
 export interface ListCommentsByResourceResponse {
@@ -1966,11 +2175,15 @@ export interface RepliesListResponse {
 export interface GetCommentThreadRequest {
     /**
      * App ID.
+     * @maxLength 128
      * @deprecated App ID.
      * @targetRemovalDate 2024-11-01
      */
     appId?: string;
-    /** Comment ID. */
+    /**
+     * Comment ID.
+     * @format GUID
+     */
     commentId: string;
     /** Comment sorting. */
     commentSort?: CommentSort;
@@ -1986,7 +2199,10 @@ export interface GetCommentThreadResponse {
     commentReplies?: Record<string, RepliesListResponse>;
 }
 export interface BulkPublishCommentRequest {
-    /** ID of the app where to publish the comment. */
+    /**
+     * ID of the app where to publish the comment.
+     * @format GUID
+     */
     appId: string;
     /** Filter to identify the comments that need to be published. Each key corresponds to an option name, and its values correspond to the choices for this option. For example, {`"resourceId"`: `"64ad407e0bf87891bba7de3a"`, `"parentComment.id"`: `"726cb137-a9c3-408b-9cc2-2b64c6be8a95"`}. */
     filter: Record<string, any> | null;
@@ -1996,11 +2212,15 @@ export interface BulkPublishCommentResponse {
      * Job ID.
      *
      * Pass this ID to Get Async Job to retrieve job details and metadata.
+     * @format GUID
      */
     jobId?: string;
 }
 export interface BulkHideCommentRequest {
-    /** ID of the app where to hide the comments. */
+    /**
+     * ID of the app where to hide the comments.
+     * @format GUID
+     */
     appId: string;
     /** Filter to identify the comments that need to be hidden. Each key corresponds to an option name, and its values correspond to the choices for this option. For example, {`"resourceId"`: `"64ad407e0bf87891bba7de3a"`, `"parentComment.id"`: `"726cb137-a9c3-408b-9cc2-2b64c6be8a95"`}. */
     filter: Record<string, any> | null;
@@ -2010,11 +2230,15 @@ export interface BulkHideCommentResponse {
      * Job ID.
      *
      * Pass this ID to Get Async Job to retrieve job details and metadata.
+     * @format GUID
      */
     jobId?: string;
 }
 export interface BulkDeleteCommentRequest {
-    /** ID of the app where to delete the comments. */
+    /**
+     * ID of the app where to delete the comments.
+     * @format GUID
+     */
     appId: string;
     /** Filter to identify the comments that need to be deleted. Each key corresponds to an option name, and its values correspond to the choices for this option. For example, {`"resourceId"`: `"64ad407e0bf87891bba7de3a"`, `"parentComment.id"`: `"726cb137-a9c3-408b-9cc2-2b64c6be8a95"`}. */
     filter: Record<string, any> | null;
@@ -2024,11 +2248,15 @@ export interface BulkDeleteCommentResponse {
      * Job ID.
      *
      * Pass this ID to Get Async Job to retrieve job details and metadata.
+     * @format GUID
      */
     jobId?: string;
 }
 export interface BulkModerateDraftContentRequest {
-    /** ID of the app where to moderate the comments. */
+    /**
+     * ID of the app where to moderate the comments.
+     * @format GUID
+     */
     appId: string;
     /** Filter to identify the comment content that needs to be moderated. Each key corresponds to an option name, and its values correspond to the choices for this option. For example, {`"resourceId"`: `"64ad407e0bf87891bba7de3a"`, `"parentComment.id"`: `"726cb137-a9c3-408b-9cc2-2b64c6be8a95"`}. */
     filter: Record<string, any> | null;
@@ -2040,11 +2268,15 @@ export interface BulkModerateDraftContentResponse {
      * Job ID.
      *
      * Pass this ID to Get Async Job to retrieve job details and metadata.
+     * @format GUID
      */
     jobId?: string;
 }
 export interface BulkMoveCommentByFilterRequest {
-    /** ID of the app from which to move the comments. */
+    /**
+     * ID of the app from which to move the comments.
+     * @format GUID
+     */
     appId: string;
     /** Filter to identify the comments that need to be moved. Each key corresponds to an option name, and its values correspond to the choices for this option. For example, {`"resourceId"`: `"64ad407e0bf87891bba7de3a"`, `"parentComment.id"`: `"726cb137-a9c3-408b-9cc2-2b64c6be8a95"`}. */
     filter: Record<string, any> | null;
@@ -2052,9 +2284,15 @@ export interface BulkMoveCommentByFilterRequest {
     destination?: Destination;
 }
 export interface Destination {
-    /** Context ID of where to move the comment to. */
+    /**
+     * Context ID of where to move the comment to.
+     * @maxLength 128
+     */
     contextId?: string;
-    /** Resource ID of where to move the comment to. */
+    /**
+     * Resource ID of where to move the comment to.
+     * @maxLength 128
+     */
     resourceId?: string;
 }
 export interface BulkMoveCommentByFilterResponse {
@@ -2062,6 +2300,7 @@ export interface BulkMoveCommentByFilterResponse {
      * Job ID.
      *
      * Pass this ID to Get Async Job to retrieve job details and metadata.
+     * @format GUID
      */
     jobId?: string;
 }
@@ -2140,9 +2379,15 @@ export interface ActionEvent {
     body?: string;
 }
 export interface MessageEnvelope {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -2150,26 +2395,50 @@ export interface MessageEnvelope {
     data?: string;
 }
 export interface IdentificationData extends IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
     /** @readonly */
     identityType?: WebhookIdentityType;
 }
 /** @oneof */
 export interface IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
 }
 export declare enum WebhookIdentityType {
@@ -2511,9 +2780,15 @@ export interface BulkMoveCommentByFilterResponseNonNullableFields {
     jobId: string;
 }
 export interface BaseEventMetadata {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -2569,6 +2844,8 @@ export interface CommentContentChangedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_comment_content_changed
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug comment_content_changed
  */
 export declare function onCommentContentChanged(handler: (event: CommentContentChangedEnvelope) => void | Promise<void>): void;
 export interface CommentHiddenEnvelope {
@@ -2584,6 +2861,8 @@ export interface CommentHiddenEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_comment_hidden
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug comment_hidden
  * @documentationMaturity preview
  */
 export declare function onCommentHidden(handler: (event: CommentHiddenEnvelope) => void | Promise<void>): void;
@@ -2600,6 +2879,8 @@ export interface CommentMarkedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_comment_marked
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug comment_marked
  */
 export declare function onCommentMarked(handler: (event: CommentMarkedEnvelope) => void | Promise<void>): void;
 export interface CommentMovedEnvelope {
@@ -2615,6 +2896,8 @@ export interface CommentMovedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_comment_moved
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug comment_moved
  * @documentationMaturity preview
  */
 export declare function onCommentMoved(handler: (event: CommentMovedEnvelope) => void | Promise<void>): void;
@@ -2631,6 +2914,8 @@ export interface CommentPublishedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_comment_published
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug comment_published
  * @documentationMaturity preview
  */
 export declare function onCommentPublished(handler: (event: CommentPublishedEnvelope) => void | Promise<void>): void;
@@ -2647,6 +2932,8 @@ export interface CommentUnmarkedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_comment_unmarked
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug comment_unmarked
  */
 export declare function onCommentUnmarked(handler: (event: CommentUnmarkedEnvelope) => void | Promise<void>): void;
 export interface CommentCreatedEnvelope {
@@ -2662,6 +2949,8 @@ export interface CommentCreatedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_created
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug created
  */
 export declare function onCommentCreated(handler: (event: CommentCreatedEnvelope) => void | Promise<void>): void;
 export interface CommentResourceCommentCountChangedEnvelope {
@@ -2677,6 +2966,8 @@ export interface CommentResourceCommentCountChangedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_resource_comment_count_changed
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug resource_comment_count_changed
  */
 export declare function onCommentResourceCommentCountChanged(handler: (event: CommentResourceCommentCountChangedEnvelope) => void | Promise<void>): void;
 export interface CommentUpdatedEnvelope {
@@ -2692,6 +2983,8 @@ export interface CommentUpdatedEnvelope {
  * @permissionId WIX_COMMENTS.COMMENT_READ
  * @webhook
  * @eventType wix.comments.v2.comment_updated
+ * @serviceIdentifier wix.comments.ng.v1.CommentsNg
+ * @slug updated
  */
 export declare function onCommentUpdated(handler: (event: CommentUpdatedEnvelope) => void | Promise<void>): void;
 /**
@@ -2760,6 +3053,7 @@ export declare function updateComment(_id: string | null, comment: UpdateComment
 export interface UpdateComment {
     /**
      * Comment ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
@@ -2782,13 +3076,19 @@ export interface UpdateComment {
      * @readonly
      */
     _updatedDate?: Date | null;
-    /** ID of the app that the comment is added to. */
+    /**
+     * ID of the app that the comment is added to.
+     * @format GUID
+     * @immutable
+     */
     appId?: string | null;
     /**
      * ID of the specific context the comment is in response to.
      *
      * Within some Wix apps, the `contextId` will be the same as the `resourceId`. For example in Wix Forum,
      * the `forumPostId` is used as both the `contextId` and the `resourceId`.
+     * @immutable
+     * @maxLength 128
      */
     contextId?: string | null;
     /**
@@ -2796,11 +3096,16 @@ export interface UpdateComment {
      *
      * Within some Wix apps, the `resourceId` will be the same as the `contextId`. For example in Wix Forum,
      * the `forumPostId` is used as both the `resourceId` and the `contextId`.
+     * @immutable
+     * @maxLength 128
      */
     resourceId?: string | null;
     /** Published comment content. */
     content?: CommentContent;
-    /** Comment's author. */
+    /**
+     * Comment's author.
+     * @immutable
+     */
     author?: CommentAuthor;
     /**
      * Parent comment information.
@@ -2837,7 +3142,10 @@ export interface UpdateComment {
     reactionSummary?: CommentReactionSummary;
     /** Whether the comment is marked. */
     marked?: boolean;
-    /** Date and time when the comment was actually created. */
+    /**
+     * Date and time when the comment was actually created.
+     * @immutable
+     */
     commentDate?: Date | null;
     /**
      * Whether the comment has the updated content.
@@ -3043,14 +3351,19 @@ export interface ListCommentsByResourceOptions {
      * ID of the specific context the comment is in response to.
      *
      * Within some Wix apps, the `contextId` will be the same as the `resourceId`. For example in Wix Forum, the `forumPostId` is used as both the `contextId` and the `resourceId`.
+     * @maxLength 128
      */
     contextId: string;
-    /** Reserved for internal use. */
+    /**
+     * Reserved for internal use.
+     * @maxLength 128
+     */
     contextType?: string;
     /**
      * ID of the specific resource that the comment is in response to.
      *
      * Within some Wix apps, the `resourceId` will be the same as the `contextId`. For example in Wix Forum, the `forumPostId` is used as both the `resourceId` and the `contextId`.
+     * @maxLength 128
      */
     resourceId: string;
     /** Comment sort. Is ignored if `cursorPaging.cursor` is defined. */
@@ -3082,6 +3395,7 @@ export declare function getCommentThread(commentId: string, options?: GetComment
 export interface GetCommentThreadOptions {
     /**
      * App ID.
+     * @maxLength 128
      * @deprecated App ID.
      * @targetRemovalDate 2024-11-01
      */