@wix/auto_sdk_comments_votes 1.0.0 → 1.0.2

package/build/internal/cjs/meta.d.ts

@@ -4,53 +4,56 @@ import '@wix/sdk-types';
 /** An upvote or downvote cast by one identity on a resource in an app context. */
 interface Vote {
     /**
-     * Vote resource ID
+     * ID of the resource receiving the vote. For comments, this is the comment ID.
      * @maxLength 128
      */
     resourceId?: string;
     /**
-     * Resource fully qualified domain name
+     * Entity type receiving the vote. For comments, this is `wix.comments.v2.comment`.
      * @maxLength 300
      */
     resourceFqdn?: string;
     /**
-     * Vote ID
+     * Vote ID.
      * @format GUID
      * @readonly
      */
     voteId?: string;
     /**
-     * Type of vote
+     * Vote type.
      * @readonly
      */
     type?: TypeWithLiterals;
     /**
-     * Vote author
+     * Identity that cast the vote.
      * @readonly
      */
     createdBy?: SocialIdentity;
     /**
-     * Vote created date
+     * Date and time the vote was created.
      * @readonly
      */
     createdDate?: Date | null;
     /**
-     * Vote updated date
+     * Date and time the vote was updated.
      * @readonly
      */
     updatedDate?: Date | null;
-    /** Vote context, defining where the vote belongs to */
+    /** App and context containing the resource. */
     context?: VoteContext;
     /**
-     * Vote revision
+     * Revision number, which increments when the vote is updated.
      * @readonly
      */
     revision?: string;
 }
-/** Type of vote */
+/** Vote type. */
 declare enum Type {
+    /** Unknown vote type. */
     UNKNOWN = "UNKNOWN",
+    /** Vote in favor of the resource. */
     UPVOTE = "UPVOTE",
+    /** Vote against the resource. */
     DOWNVOTE = "DOWNVOTE"
 }
 /** @enumType */
@@ -72,20 +75,20 @@ declare enum IdentityType {
 type IdentityTypeWithLiterals = IdentityType | 'ANONYMOUS' | 'MEMBER' | 'USER' | 'SERVICE' | 'MEMBER_GROUP';
 interface VoteContext {
     /**
-     * Context ID
+     * ID of the context containing the resource.
      * @maxLength 128
      */
     contextId?: string;
-    /** Context type */
+    /** Type used by the app to identify the context. */
     contextType?: string | null;
     /**
-     * Vote app ID
+     * ID of the app that owns the context.
      * @format GUID
      * @readonly
      */
     appDefId?: string;
     /**
-     * MetaSite ID
+     * Site ID.
      * @format GUID
      * @readonly
      */
@@ -93,27 +96,27 @@ interface VoteContext {
 }
 interface UpvoteRequest {
     /**
-     * context token to be passed
+     * Legacy context token. Use `contextData` instead.
      * @deprecated
      * @replacedBy context_data
      */
     contextToken?: string;
     /**
-     * resource identifier for vote be cast on
+     * ID of the resource receiving the vote. For a comment, specify the comment ID.
      * @maxLength 128
      */
     resourceId: string;
     /**
-     * resource name
+     * Entity type receiving the vote. For comments, specify `wix.comments.v2.comment`.
      * @maxLength 300
      */
     resourceFqdn: string;
-    /** context data */
+    /** App and context containing the resource. */
     contextData?: ContextData;
 }
 /**
  * Identifies the app and context containing the resource.
- * When provided, contextData takes precedence over the deprecated contextToken.
+ * When provided, `contextData` takes precedence over the deprecated `contextToken`.
  */
 interface ContextData {
     /**
@@ -130,55 +133,55 @@ interface ContextData {
     contextType?: string | null;
 }
 interface UpvoteResponse {
-    /** created vote */
+    /** Vote cast or updated. */
     vote?: Vote;
 }
 interface ContextResourceVoteChange {
     /**
-     * Resource ID
+     * ID of the resource receiving the vote.
      * @maxLength 128
      */
     resourceId?: string;
     /**
-     * Resource fully qualified domain name
+     * Entity type receiving the vote. For comments, this is `wix.comments.v2.comment`.
      * @maxLength 300
      */
     resourceFqdn?: string;
-    /** Score of votes */
+    /** Net score: upvote count minus downvote count. */
     score?: number;
-    /** Upvote count */
+    /** Number of upvotes. */
     upvoteCount?: number;
-    /** Downvote count */
+    /** Number of downvotes. */
     downvoteCount?: number;
-    /** Vote context */
+    /** App and context containing the resource. */
     context?: VoteContext;
 }
 interface VoteCast {
-    /** Vote */
+    /** Vote associated with the event. */
     vote?: Vote;
 }
 interface DownvoteRequest {
     /**
-     * context token to be passed
+     * Legacy context token. Use `contextData` instead.
      * @deprecated
      * @replacedBy context_data
      */
     contextToken?: string;
     /**
-     * resource identifier for vote be cast on
+     * ID of the resource receiving the vote. For a comment, specify the comment ID.
      * @maxLength 128
      */
     resourceId: string;
     /**
-     * resource name
+     * Entity type receiving the vote. For comments, specify `wix.comments.v2.comment`.
      * @maxLength 300
      */
     resourceFqdn: string;
-    /** context data */
+    /** App and context containing the resource. */
     contextData?: ContextData;
 }
 interface DownvoteResponse {
-    /** created vote */
+    /** Vote cast or updated. */
     vote?: Vote;
 }
 interface UpdateVoteRequest {
@@ -196,34 +199,34 @@ interface UpdateVoteResponse {
 }
 interface RemoveVoteRequest {
     /**
-     * context token to be passed
+     * Legacy context token. Use `contextData` instead.
      * @deprecated
      * @replacedBy context_data
      */
     contextToken?: string;
-    /** id of the vote which will be deleted */
+    /** ID of the vote to remove. */
     voteId: string;
-    /** context data */
+    /** App and context containing the resource. */
     contextData?: ContextData;
 }
 interface RemoveVoteResponse {
-    /** removed vote */
+    /** Vote removed. */
     vote?: Vote;
 }
 interface VoteDeleted {
-    /** Vote */
+    /** Vote associated with the event. */
     vote?: Vote;
 }
 interface QueryVotesRequest {
     /**
-     * context token to be passed
+     * Legacy context token. Use `contextData` instead.
      * @deprecated
      * @replacedBy context_data
      */
     contextToken?: string;
-    /** query request. Filter supports only "resourceId" field. Fields and Fieldset are not supported */
+    /** Query options. Filter by `resourceId`. Field projection and fieldsets aren't supported. */
     query?: QueryV2;
-    /** context data */
+    /** App and context containing the resource. */
     contextData?: ContextData;
 }
 interface QueryV2 extends QueryV2PagingMethodOneOf {
@@ -317,9 +320,9 @@ interface CursorPaging {
     cursor?: string | null;
 }
 interface QueryVotesResponse {
-    /** matching votes */
+    /** Votes matching the query. */
     votes?: Vote[];
-    /** paging metadata. Only contains cursors */
+    /** Paging metadata containing cursors for retrieving additional results. */
     paging?: PagingMetadataV2;
 }
 interface PagingMetadataV2 {

package/build/internal/es/index.d.mts

@@ -6,11 +6,13 @@ declare function upvote$1(httpClient: HttpClient): UpvoteSignature;
 interface UpvoteSignature {
     /**
      * Casts an upvote on a resource for the current identity.
-     * Changes an existing downvote to an upvote. Repeating an upvote does not remove it.
-     * Provide contextData for the app and context. Context voting permissions apply.
-     * Authorization is enforced by the service for the current identity and context.
+     *
+     * Changes the current identity's existing downvote to an upvote.
+     * Repeating the same vote doesn't remove it. To clear a vote, call
+     * [Remove Vote](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/comments/vote-v1/remove-vote).
+     * Specify the resource's app and context in `contextData`. Voting must be enabled for that context.
      */
-    (options?: NonNullablePaths<UpvoteOptions, `resourceFqdn` | `resourceId`, 2>): Promise<NonNullablePaths<UpvoteResponse, `vote.resourceId` | `vote.resourceFqdn` | `vote.voteId` | `vote.type` | `vote.createdBy.identityId` | `vote.createdBy.identityType` | `vote.context.contextId` | `vote.context.appDefId` | `vote.context.metaSiteId` | `vote.revision`, 4> & {
+    (options?: NonNullablePaths<UpvoteOptions, `resourceFqdn` | `resourceId`, 0>): Promise<NonNullablePaths<UpvoteResponse, `vote.resourceId` | `vote.resourceFqdn` | `vote.voteId` | `vote.type` | `vote.createdBy.identityId` | `vote.createdBy.identityType` | `vote.context.contextId` | `vote.context.appDefId` | `vote.context.metaSiteId` | `vote.revision`, 2> & {
         __applicationErrorsType?: UpvoteApplicationErrors;
     }>;
 }
@@ -18,23 +20,27 @@ declare function downvote$1(httpClient: HttpClient): DownvoteSignature;
 interface DownvoteSignature {
     /**
      * Casts a downvote on a resource for the current identity.
-     * Changes an existing upvote to a downvote. Use RemoveVote to clear a vote.
-     * Provide contextData for the app and context. Context voting permissions apply.
-     * Authorization is enforced by the service for the current identity and context.
+     *
+     * Changes the current identity's existing upvote to a downvote.
+     * Repeating the same vote doesn't remove it. To clear a vote, call
+     * [Remove Vote](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/comments/vote-v1/remove-vote).
+     * Specify the resource's app and context in `contextData`. Voting must be enabled for that context.
      */
-    (options?: NonNullablePaths<DownvoteOptions, `resourceFqdn` | `resourceId`, 2>): Promise<NonNullablePaths<DownvoteResponse, `vote.resourceId` | `vote.resourceFqdn` | `vote.voteId` | `vote.type` | `vote.createdBy.identityId` | `vote.createdBy.identityType` | `vote.context.contextId` | `vote.context.appDefId` | `vote.context.metaSiteId` | `vote.revision`, 4> & {
+    (options?: NonNullablePaths<DownvoteOptions, `resourceFqdn` | `resourceId`, 0>): Promise<NonNullablePaths<DownvoteResponse, `vote.resourceId` | `vote.resourceFqdn` | `vote.voteId` | `vote.type` | `vote.createdBy.identityId` | `vote.createdBy.identityType` | `vote.context.contextId` | `vote.context.appDefId` | `vote.context.metaSiteId` | `vote.revision`, 2> & {
         __applicationErrorsType?: DownvoteApplicationErrors;
     }>;
 }
 declare function removeVote$1(httpClient: HttpClient): RemoveVoteSignature;
 interface RemoveVoteSignature {
     /**
-     * Removes the current identity's vote in the specified context and returns it.
-     * Obtain voteId from a vote response or QueryVotes. A repeated removal can fail.
-     * Authorization is enforced by the service for the current identity and context.
-     * @param - id of the vote which will be deleted
+     * Removes the current identity's vote and returns the removed vote.
+     *
+     * Specify the `voteId` returned by a vote response or
+     * [Query Votes](https://dev.wix.com/docs/api-reference/crm/community/feedback-moderation/comments/vote-v1/query-votes) and the same `contextData` used to cast the vote.
+     * A repeated removal fails when the vote no longer exists.
+     * @param - ID of the vote to remove.
      */
-    (voteId: string, options?: RemoveVoteOptions): Promise<NonNullablePaths<RemoveVoteResponse, `vote.resourceId` | `vote.resourceFqdn` | `vote.voteId` | `vote.type` | `vote.createdBy.identityId` | `vote.createdBy.identityType` | `vote.context.contextId` | `vote.context.appDefId` | `vote.context.metaSiteId` | `vote.revision`, 4> & {
+    (voteId: string, options?: RemoveVoteOptions): Promise<NonNullablePaths<RemoveVoteResponse, `vote.resourceId` | `vote.resourceFqdn` | `vote.voteId` | `vote.type` | `vote.createdBy.identityId` | `vote.createdBy.identityType` | `vote.context.contextId` | `vote.context.appDefId` | `vote.context.metaSiteId` | `vote.revision`, 2> & {
         __applicationErrorsType?: RemoveVoteApplicationErrors;
     }>;
 }
@@ -50,11 +56,17 @@ declare const upvote: MaybeContext<BuildRESTFunction<typeof upvote$1> & typeof u
 declare const downvote: MaybeContext<BuildRESTFunction<typeof downvote$1> & typeof downvote$1>;
 declare const removeVote: MaybeContext<BuildRESTFunction<typeof removeVote$1> & typeof removeVote$1>;
 declare const queryVotes: MaybeContext<BuildRESTFunction<typeof customQueryVotes> & typeof customQueryVotes>;
-/** */
+/**
+ * Triggered when a vote changes the totals for a resource.
+ */
 declare const onVoteContextResourceVoteChange: BuildEventDefinition<typeof onVoteContextResourceVoteChange$1> & typeof onVoteContextResourceVoteChange$1;
-/** */
+/**
+ * Triggered when an upvote or downvote is cast, including changes to an existing vote.
+ */
 declare const onVoteCast: BuildEventDefinition<typeof onVoteCast$1> & typeof onVoteCast$1;
-/** */
+/**
+ * Triggered when a vote is removed.
+ */
 declare const onVoteDeleted: BuildEventDefinition<typeof onVoteDeleted$1> & typeof onVoteDeleted$1;
 
 export { DownvoteApplicationErrors, DownvoteOptions, DownvoteResponse, QueryVotesOptions, RemoveVoteApplicationErrors, RemoveVoteOptions, RemoveVoteResponse, UpvoteApplicationErrors, UpvoteOptions, UpvoteResponse, VoteCastEnvelope, VoteContextResourceVoteChangeEnvelope, VoteDeletedEnvelope, VoteQuery, VotesQueryBuilder, downvote, onVoteCast, onVoteContextResourceVoteChange, onVoteDeleted, queryVotes, removeVote, upvote };