@wix/portfolio 1.0.96 → 1.0.98

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2461,55 +2461,56 @@ declare namespace context$3 {
2461
2461
  export { type ActionEvent$3 as ActionEvent, type App$1 as App, type ApplicationError$1 as ApplicationError, type BaseEventMetadata$2 as BaseEventMetadata, type BulkActionMetadata$1 as BulkActionMetadata, type context$3_BulkCreateProjectItemResult as BulkCreateProjectItemResult, type context$3_BulkCreateProjectItemsOptions as BulkCreateProjectItemsOptions, type context$3_BulkCreateProjectItemsRequest as BulkCreateProjectItemsRequest, type context$3_BulkCreateProjectItemsResponse as BulkCreateProjectItemsResponse, type context$3_BulkCreateProjectItemsResponseNonNullableFields as BulkCreateProjectItemsResponseNonNullableFields, type context$3_BulkDeleteProjectItemResult as BulkDeleteProjectItemResult, type context$3_BulkDeleteProjectItemsOptions as BulkDeleteProjectItemsOptions, type context$3_BulkDeleteProjectItemsRequest as BulkDeleteProjectItemsRequest, type context$3_BulkDeleteProjectItemsResponse as BulkDeleteProjectItemsResponse, type context$3_BulkDeleteProjectItemsResponseNonNullableFields as BulkDeleteProjectItemsResponseNonNullableFields, type context$3_BulkUpdateProjectItemResult as BulkUpdateProjectItemResult, type context$3_BulkUpdateProjectItemsOptions as BulkUpdateProjectItemsOptions, type context$3_BulkUpdateProjectItemsRequest as BulkUpdateProjectItemsRequest, type context$3_BulkUpdateProjectItemsResponse as BulkUpdateProjectItemsResponse, type context$3_BulkUpdateProjectItemsResponseNonNullableFields as BulkUpdateProjectItemsResponseNonNullableFields, type context$3_CreateProjectGalleryRequest as CreateProjectGalleryRequest, type context$3_CreateProjectGalleryResponse as CreateProjectGalleryResponse, type context$3_CreateProjectItemRequest as CreateProjectItemRequest, type context$3_CreateProjectItemResponse as CreateProjectItemResponse, type context$3_CreateProjectItemResponseNonNullableFields as CreateProjectItemResponseNonNullableFields, type CursorPaging$3 as CursorPaging, type Cursors$3 as Cursors, type context$3_DeleteProjectItemRequest as DeleteProjectItemRequest, type context$3_DeleteProjectItemResponse as DeleteProjectItemResponse, type context$3_DeleteProjectItemResponseNonNullableFields as DeleteProjectItemResponseNonNullableFields, type DeletedProjectRestored$1 as DeletedProjectRestored, type DomainEvent$3 as DomainEvent, type DomainEventBodyOneOf$3 as DomainEventBodyOneOf, type context$3_DuplicateProjectItemsOptions as DuplicateProjectItemsOptions, type context$3_DuplicateProjectItemsRequest as DuplicateProjectItemsRequest, type context$3_DuplicateProjectItemsResponse as DuplicateProjectItemsResponse, type context$3_DuplicateProjectItemsResponseNonNullableFields as DuplicateProjectItemsResponseNonNullableFields, type Empty$2 as Empty, type EntityCreatedEvent$3 as EntityCreatedEvent, type EntityDeletedEvent$3 as EntityDeletedEvent, type EntityUpdatedEvent$3 as EntityUpdatedEvent, type EventMetadata$2 as EventMetadata, type File$1 as File, type context$3_GenerateTokenForProjectItemsRequest as GenerateTokenForProjectItemsRequest, type context$3_GenerateTokenForProjectItemsResponse as GenerateTokenForProjectItemsResponse, type context$3_GetProjectItemRequest as GetProjectItemRequest, type context$3_GetProjectItemResponse as GetProjectItemResponse, type context$3_GetProjectItemResponseNonNullableFields as GetProjectItemResponseNonNullableFields, type IdentificationData$3 as IdentificationData, type IdentificationDataIdOneOf$3 as IdentificationDataIdOneOf, type Image$2 as Image, ImageType$2 as ImageType, type InvalidateCache$1 as InvalidateCache, type InvalidateCacheGetByOneOf$1 as InvalidateCacheGetByOneOf, type context$3_Item as Item, type ItemMetadata$1 as ItemMetadata, type context$3_ItemMetadataOneOf as ItemMetadataOneOf, type context$3_ItemNonNullableFields as ItemNonNullableFields, type context$3_Link as Link, type context$3_ListProjectItemsOptions as ListProjectItemsOptions, type context$3_ListProjectItemsRequest as ListProjectItemsRequest, type context$3_ListProjectItemsResponse as ListProjectItemsResponse, type context$3_ListProjectItemsResponseNonNullableFields as ListProjectItemsResponseNonNullableFields, type context$3_MaskedItem as MaskedItem, type MessageEnvelope$3 as MessageEnvelope, type Page$1 as Page, type Paging$2 as Paging, type PagingMetadataV2$3 as PagingMetadataV2, type Point$2 as Point, type context$3_ProjectItemCreatedEnvelope as ProjectItemCreatedEnvelope, type context$3_ProjectItemDeletedEnvelope as ProjectItemDeletedEnvelope, type context$3_ProjectItemMediaToken as ProjectItemMediaToken, type context$3_ProjectItemUpdatedEnvelope as ProjectItemUpdatedEnvelope, type context$3_QueryProjectItemsRequest as QueryProjectItemsRequest, type context$3_QueryProjectItemsResponse as QueryProjectItemsResponse, type QueryV2$2 as QueryV2, type QueryV2PagingMethodOneOf$2 as QueryV2PagingMethodOneOf, type RestoreInfo$3 as RestoreInfo, SortOrder$2 as SortOrder, type Sorting$2 as Sorting, type context$3_Tags as Tags, context$3_Type as Type, type URI$1 as URI, type UnsharpMasking$2 as UnsharpMasking, type context$3_UpdateProjectItem as UpdateProjectItem, type context$3_UpdateProjectItemRequest as UpdateProjectItemRequest, type context$3_UpdateProjectItemResponse as UpdateProjectItemResponse, type context$3_UpdateProjectItemResponseNonNullableFields as UpdateProjectItemResponseNonNullableFields, type Video$2 as Video, type VideoResolution$2 as VideoResolution, WebhookIdentityType$3 as WebhookIdentityType, type context$3__publicOnProjectItemCreatedType as _publicOnProjectItemCreatedType, type context$3__publicOnProjectItemDeletedType as _publicOnProjectItemDeletedType, type context$3__publicOnProjectItemUpdatedType as _publicOnProjectItemUpdatedType, context$3_bulkCreateProjectItems as bulkCreateProjectItems, context$3_bulkDeleteProjectItems as bulkDeleteProjectItems, context$3_bulkUpdateProjectItems as bulkUpdateProjectItems, context$3_createProjectItem as createProjectItem, context$3_deleteProjectItem as deleteProjectItem, context$3_duplicateProjectItems as duplicateProjectItems, context$3_getProjectItem as getProjectItem, context$3_listProjectItems as listProjectItems, context$3_onProjectItemCreated as onProjectItemCreated, context$3_onProjectItemDeleted as onProjectItemDeleted, context$3_onProjectItemUpdated as onProjectItemUpdated, onProjectItemCreated$1 as publicOnProjectItemCreated, onProjectItemDeleted$1 as publicOnProjectItemDeleted, onProjectItemUpdated$1 as publicOnProjectItemUpdated, context$3_updateProjectItem as updateProjectItem };
2462
2462
  }
2463
2463
 
2464
- /** Project is the main entity of ProjectsService */
2465
2464
  interface Project$1 extends ProjectCoverOneOf$1 {
2466
- /** project's cover photo */
2465
+ /** Project cover image. */
2467
2466
  coverImage?: Image$1;
2468
- /** project's cover video */
2467
+ /** Project cover video. */
2469
2468
  coverVideo?: Video$1;
2470
2469
  /**
2471
- * Project ID
2470
+ * Project ID.
2472
2471
  * @readonly
2473
2472
  */
2474
2473
  _id?: string | null;
2475
2474
  /**
2476
- * Represents the current state of an item. Each time the item is modified, its `revision` changes. for an update operation to succeed, you MUST pass the latest revision
2475
+ * Revision number, which increments by 1 each time the project is updated. To prevent conflicting changes, the existing revision must be passed when updating the project object.
2477
2476
  * @readonly
2478
2477
  */
2479
2478
  revision?: string | null;
2479
+ /** Project title. */
2480
2480
  title?: string | null;
2481
+ /** Project description. */
2481
2482
  description?: string | null;
2482
- /** indicates if the project should be hidden from Portfolio */
2483
+ /** Whether the project is hidden from the portfolio. */
2483
2484
  hidden?: boolean | null;
2484
- /** Collections must exist to be added to a project. Can be created/updated/deleted using [Collection Service](https://dev.wix.com/docs/rest/business-solutions/portfolio/collection) */
2485
+ /** IDs of the collections that include the project. */
2485
2486
  collectionIds?: string[];
2486
- /** Custom project details */
2487
+ /** Project details. */
2487
2488
  details?: ProjectDetail$1[];
2488
- /** Project's slug */
2489
+ /** Project slug. */
2489
2490
  slug?: string | null;
2490
2491
  /**
2491
- * Represents the time this Project was created
2492
+ * Date and time the project was created.
2492
2493
  * @readonly
2493
2494
  */
2494
2495
  _createdDate?: Date;
2495
2496
  /**
2496
- * Represents the time this Project was last updated
2497
+ * Date and time the project was updated.
2497
2498
  * @readonly
2498
2499
  */
2499
2500
  _updatedDate?: Date;
2500
2501
  /**
2501
- * Url and relative url of Project - in order to receive this field in READ requests you will need to pass the `include_page_url` field as part of request
2502
+ * Project's page URL and relative path. To receive this field in the response, pass the `includePageUrl` query parameter in the request.
2502
2503
  * @readonly
2503
2504
  */
2504
2505
  url?: string;
2505
- /** SEO data for the project */
2506
+ /** Project SEO data. */
2506
2507
  seoData?: SeoSchema$1;
2507
2508
  }
2508
2509
  /** @oneof */
2509
2510
  interface ProjectCoverOneOf$1 {
2510
- /** project's cover photo */
2511
+ /** Project cover image. */
2511
2512
  coverImage?: Image$1;
2512
- /** project's cover video */
2513
+ /** Project cover video. */
2513
2514
  coverVideo?: Video$1;
2514
2515
  }
2515
2516
  interface Image$1 {
@@ -2567,21 +2568,30 @@ interface VideoResolution$1 {
2567
2568
  /** Video filename. */
2568
2569
  filename?: string | null;
2569
2570
  }
2571
+ /**
2572
+ * Project label.
2573
+ * One of:
2574
+ * + `text`
2575
+ * + `link`
2576
+ */
2570
2577
  interface ProjectDetail$1 extends ProjectDetailValueOneOf$1 {
2578
+ /** Project label in plain text format. */
2571
2579
  text?: string;
2572
- /** Details link */
2580
+ /** Project label in link format. */
2573
2581
  link?: DetailsLink$1;
2574
2582
  label?: string;
2575
2583
  }
2576
2584
  /** @oneof */
2577
2585
  interface ProjectDetailValueOneOf$1 {
2586
+ /** Project label in plain text format. */
2578
2587
  text?: string;
2579
- /** Details link */
2588
+ /** Project label in link format. */
2580
2589
  link?: DetailsLink$1;
2581
2590
  }
2582
2591
  interface DetailsLink$1 {
2592
+ /** Display text of the link. */
2583
2593
  text?: string | null;
2584
- /** link to external source */
2594
+ /** Target URL of the link. */
2585
2595
  url?: string | null;
2586
2596
  /**
2587
2597
  * Whether the link opens in a new tab or window. One of:
@@ -3087,27 +3097,27 @@ interface DeletedProjectRestored {
3087
3097
  deletionTimestamp?: Date;
3088
3098
  }
3089
3099
  interface CreateProjectRequest {
3090
- /** Project to be created */
3100
+ /** Project to create. */
3091
3101
  project: Project$1;
3092
3102
  }
3093
3103
  interface CreateProjectResponse {
3094
- /** The created Project */
3104
+ /** Created project. */
3095
3105
  project?: Project$1;
3096
3106
  }
3097
3107
  interface GetProjectRequest {
3098
- /** Id of the Project to retrieve */
3108
+ /** ID of the project to retrieve. */
3099
3109
  projectId: string;
3100
3110
  /** Include page url */
3101
3111
  includePageUrl?: boolean | null;
3102
3112
  }
3103
3113
  interface GetProjectResponse {
3104
- /** The retrieved Project */
3114
+ /** The requested project. */
3105
3115
  project?: Project$1;
3106
3116
  }
3107
3117
  interface ListProjectsRequest {
3108
- /** Projects limit per response is maximum 100, In the first request the cursor is None */
3118
+ /** Projects limit per response is maximum 100, In the first request the cursor is None ? */
3109
3119
  paging?: CursorPaging$2;
3110
- /** Include page url */
3120
+ /** Include page url ? */
3111
3121
  includePageUrl?: boolean | null;
3112
3122
  }
3113
3123
  interface CursorPaging$2 {
@@ -3122,9 +3132,9 @@ interface CursorPaging$2 {
3122
3132
  cursor?: string | null;
3123
3133
  }
3124
3134
  interface ListProjectsResponse {
3125
- /** The retrieved Projects */
3135
+ /** List of projects. */
3126
3136
  projects?: Project$1[];
3127
- /** Paging metadata */
3137
+ /** Paging metadata ? */
3128
3138
  metadata?: PagingMetadataV2$2;
3129
3139
  }
3130
3140
  interface PagingMetadataV2$2 {
@@ -3146,33 +3156,33 @@ interface Cursors$2 {
3146
3156
  prev?: string | null;
3147
3157
  }
3148
3158
  interface UpdateProjectRequest {
3149
- /** Project to be updated, may be partial */
3159
+ /** Project to update. */
3150
3160
  project: Project$1;
3151
3161
  }
3152
3162
  interface UpdateProjectResponse {
3153
- /** The updated Project */
3163
+ /** Updated project. */
3154
3164
  project?: Project$1;
3155
3165
  }
3156
3166
  interface BulkUpdateProjectsRequest {
3157
- /** projects to be updated. */
3167
+ /** Projects to update. */
3158
3168
  projects?: MaskedProject[];
3159
- /** Flag to return full entity in response */
3169
+ /** Whether to include the updated projects in the response. Set to `true`` to receive the projects in the response. */
3160
3170
  returnFullEntity?: boolean | null;
3161
3171
  }
3162
3172
  interface MaskedProject {
3163
- /** Project to be updated */
3173
+ /** Project to update. */
3164
3174
  project?: Project$1;
3165
3175
  }
3166
3176
  interface BulkUpdateProjectsResponse {
3167
- /** Array with all updated items results. */
3177
+ /** Items created by bulk action. */
3168
3178
  results?: BulkUpdateProjectsResult[];
3169
- /** Holds metadata of the entire bulk update operation */
3179
+ /** Bulk action metadata. */
3170
3180
  bulkActionMetadata?: BulkActionMetadata;
3171
3181
  }
3172
3182
  interface BulkUpdateProjectsResult {
3173
- /** Holds information about an item in bulk update - id, index in original request array, action successful, error (if failed). */
3183
+ /** Item metadata. */
3174
3184
  itemMetadata?: ItemMetadata;
3175
- /** Updated Project */
3185
+ /** Updated project. */
3176
3186
  project?: Project$1;
3177
3187
  }
3178
3188
  interface ItemMetadata {
@@ -3202,17 +3212,17 @@ interface BulkActionMetadata {
3202
3212
  undetailedFailures?: number;
3203
3213
  }
3204
3214
  interface DeleteProjectRequest {
3205
- /** Id of the Project to delete */
3215
+ /** ID of the project to delete. */
3206
3216
  projectId: string;
3207
3217
  }
3208
3218
  interface DeleteProjectResponse {
3209
- /** Id of the deleted Project */
3219
+ /** ID of the deleted project. */
3210
3220
  projectId?: string;
3211
3221
  }
3212
3222
  interface QueryProjectsRequest {
3213
- /** WQL expression */
3223
+ /** Query options. */
3214
3224
  query: QueryV2$1;
3215
- /** Include page url */
3225
+ /** Include page url ? */
3216
3226
  includePageUrl?: boolean | null;
3217
3227
  }
3218
3228
  interface QueryV2$1 extends QueryV2PagingMethodOneOf$1 {
@@ -3261,29 +3271,33 @@ interface Paging$1 {
3261
3271
  offset?: number | null;
3262
3272
  }
3263
3273
  interface QueryProjectsResponse {
3264
- /** The retrieved Projects */
3274
+ /** List of projects. */
3265
3275
  projects?: Project$1[];
3266
- /** Paging metadata */
3276
+ /** Paging metadata ? */
3267
3277
  metadata?: PagingMetadataV2$2;
3268
3278
  }
3269
3279
  interface UpdateProjectOrderInCollectionRequest$1 {
3270
- /** Id of the Project to update its order */
3280
+ /** ID of the project to update. */
3271
3281
  projectId: string;
3272
- /** Id of the collection in which the project will be re-ordered */
3282
+ /** Collection ID. */
3273
3283
  collectionId: string;
3274
- /** The new sort order of the project in the given collection */
3284
+ /** Sort order of the project within the specified collection. */
3275
3285
  sortOrder: number | null;
3276
3286
  }
3277
3287
  interface UpdateProjectOrderInCollectionResponse$1 {
3278
- /** project with new sort order set */
3288
+ /** Updated project within the specified collection. */
3279
3289
  projectInCollection?: ProjectInCollection$1;
3280
3290
  }
3281
3291
  interface ProjectInCollection$1 {
3282
- /** Collection ID */
3292
+ /** Collection ID. */
3283
3293
  collectionId?: string;
3284
- /** Project */
3294
+ /** Project object. */
3285
3295
  project?: Project$1;
3286
- /** The sort order of the project in the given Collection */
3296
+ /**
3297
+ * Sort order of the project within the specified collection. <br />
3298
+ *
3299
+ * Default: [Epoch](https://www.epoch101.com/) timestamp. <br />
3300
+ */
3287
3301
  sortOrder?: number | null;
3288
3302
  }
3289
3303
  interface QueryProjectWithCollectionInfoRequest {
@@ -3554,62 +3568,64 @@ interface GetProjectOptions {
3554
3568
  includePageUrl?: boolean | null;
3555
3569
  }
3556
3570
  interface ListProjectsOptions {
3557
- /** Projects limit per response is maximum 100, In the first request the cursor is None */
3571
+ /** Projects limit per response is maximum 100, In the first request the cursor is None ? */
3558
3572
  paging?: CursorPaging$2;
3559
- /** Include page url */
3573
+ /** Include page url ? */
3560
3574
  includePageUrl?: boolean | null;
3561
3575
  }
3562
3576
  interface UpdateProject {
3563
- /** project's cover photo */
3577
+ /** Project cover image. */
3564
3578
  coverImage?: Image$1;
3565
- /** project's cover video */
3579
+ /** Project cover video. */
3566
3580
  coverVideo?: Video$1;
3567
3581
  /**
3568
- * Project ID
3582
+ * Project ID.
3569
3583
  * @readonly
3570
3584
  */
3571
3585
  _id?: string | null;
3572
3586
  /**
3573
- * Represents the current state of an item. Each time the item is modified, its `revision` changes. for an update operation to succeed, you MUST pass the latest revision
3587
+ * Revision number, which increments by 1 each time the project is updated. To prevent conflicting changes, the existing revision must be passed when updating the project object.
3574
3588
  * @readonly
3575
3589
  */
3576
3590
  revision?: string | null;
3591
+ /** Project title. */
3577
3592
  title?: string | null;
3593
+ /** Project description. */
3578
3594
  description?: string | null;
3579
- /** indicates if the project should be hidden from Portfolio */
3595
+ /** Whether the project is hidden from the portfolio. */
3580
3596
  hidden?: boolean | null;
3581
- /** Collections must exist to be added to a project. Can be created/updated/deleted using [Collection Service](https://dev.wix.com/docs/rest/business-solutions/portfolio/collection) */
3597
+ /** IDs of the collections that include the project. */
3582
3598
  collectionIds?: string[];
3583
- /** Custom project details */
3599
+ /** Project details. */
3584
3600
  details?: ProjectDetail$1[];
3585
- /** Project's slug */
3601
+ /** Project slug. */
3586
3602
  slug?: string | null;
3587
3603
  /**
3588
- * Represents the time this Project was created
3604
+ * Date and time the project was created.
3589
3605
  * @readonly
3590
3606
  */
3591
3607
  _createdDate?: Date;
3592
3608
  /**
3593
- * Represents the time this Project was last updated
3609
+ * Date and time the project was updated.
3594
3610
  * @readonly
3595
3611
  */
3596
3612
  _updatedDate?: Date;
3597
3613
  /**
3598
- * Url and relative url of Project - in order to receive this field in READ requests you will need to pass the `include_page_url` field as part of request
3614
+ * Project's page URL and relative path. To receive this field in the response, pass the `includePageUrl` query parameter in the request.
3599
3615
  * @readonly
3600
3616
  */
3601
3617
  url?: string;
3602
- /** SEO data for the project */
3618
+ /** Project SEO data. */
3603
3619
  seoData?: SeoSchema$1;
3604
3620
  }
3605
3621
  interface BulkUpdateProjectsOptions {
3606
- /** projects to be updated. */
3622
+ /** Projects to update. */
3607
3623
  projects?: MaskedProject[];
3608
- /** Flag to return full entity in response */
3624
+ /** Whether to include the updated projects in the response. Set to `true`` to receive the projects in the response. */
3609
3625
  returnFullEntity?: boolean | null;
3610
3626
  }
3611
3627
  interface QueryProjectsOptions {
3612
- /** Include page url */
3628
+ /** Include page url ? */
3613
3629
  includePageUrl?: boolean | null | undefined;
3614
3630
  }
3615
3631
  interface QueryCursorResult$1 {
@@ -3695,9 +3711,9 @@ interface ProjectsQueryBuilder {
3695
3711
  find: () => Promise<ProjectsQueryResult>;
3696
3712
  }
3697
3713
  interface UpdateProjectOrderInCollectionIdentifiers$1 {
3698
- /** Id of the Project to update its order */
3714
+ /** ID of the project to update. */
3699
3715
  projectId: string;
3700
- /** Id of the collection in which the project will be re-ordered */
3716
+ /** Collection ID. */
3701
3717
  collectionId: string;
3702
3718
  }
3703
3719
  interface QueryProjectsWithCollectionInfoOptions {
@@ -3715,57 +3731,61 @@ interface GetProjectPageDataSignature {
3715
3731
  declare function createProject$1(httpClient: HttpClient): CreateProjectSignature;
3716
3732
  interface CreateProjectSignature {
3717
3733
  /**
3718
- * Creates a new Project
3719
- * @param - Project to be created
3720
- * @returns The created Project
3734
+ * Creates a project.
3735
+ * @param - Project to create.
3736
+ * @returns Created project.
3721
3737
  */
3722
3738
  (project: Project$1): Promise<Project$1 & ProjectNonNullableFields$1>;
3723
3739
  }
3724
3740
  declare function getProject$1(httpClient: HttpClient): GetProjectSignature;
3725
3741
  interface GetProjectSignature {
3726
3742
  /**
3727
- * Get a Project by id
3728
- * @param - Id of the Project to retrieve
3729
- * @returns The retrieved Project
3743
+ * Retrieves a project.
3744
+ * @param - ID of the project to retrieve.
3745
+ * @returns The requested project.
3730
3746
  */
3731
3747
  (projectId: string, options?: GetProjectOptions | undefined): Promise<Project$1 & ProjectNonNullableFields$1>;
3732
3748
  }
3733
3749
  declare function listProjects$1(httpClient: HttpClient): ListProjectsSignature;
3734
3750
  interface ListProjectsSignature {
3735
3751
  /**
3736
- * List all projects in portfolio by creation date
3752
+ * Retrieves a list of all projects in a portfolio.
3737
3753
  */
3738
3754
  (options?: ListProjectsOptions | undefined): Promise<ListProjectsResponse & ListProjectsResponseNonNullableFields>;
3739
3755
  }
3740
3756
  declare function updateProject$1(httpClient: HttpClient): UpdateProjectSignature;
3741
3757
  interface UpdateProjectSignature {
3742
3758
  /**
3743
- * Update a Project, supports partial update
3744
- * Pass the latest `revision` for a successful update
3745
- * @param - Project ID
3746
- * @returns The updated Project
3759
+ * Updates a project.
3760
+ * @param - Project ID.
3761
+ * @returns Updated project.
3747
3762
  */
3748
3763
  (_id: string | null, project: UpdateProject): Promise<Project$1 & ProjectNonNullableFields$1>;
3749
3764
  }
3750
3765
  declare function bulkUpdateProjects$1(httpClient: HttpClient): BulkUpdateProjectsSignature;
3751
3766
  interface BulkUpdateProjectsSignature {
3752
3767
  /**
3753
- * Update Projects in bulk
3768
+ * Updates multiple projects.
3754
3769
  */
3755
3770
  (options?: BulkUpdateProjectsOptions | undefined): Promise<BulkUpdateProjectsResponse & BulkUpdateProjectsResponseNonNullableFields>;
3756
3771
  }
3757
3772
  declare function deleteProject$1(httpClient: HttpClient): DeleteProjectSignature;
3758
3773
  interface DeleteProjectSignature {
3759
3774
  /**
3760
- * Delete a Project
3761
- * @param - Id of the Project to delete
3775
+ * Deletes a project.
3776
+ * @param - ID of the project to delete.
3762
3777
  */
3763
3778
  (projectId: string): Promise<DeleteProjectResponse & DeleteProjectResponseNonNullableFields>;
3764
3779
  }
3765
3780
  declare function queryProjects$1(httpClient: HttpClient): QueryProjectsSignature;
3766
3781
  interface QueryProjectsSignature {
3767
3782
  /**
3768
- * Query Projects using [WQL - Wix Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language)
3783
+ * Retrieves a list of projects, given the provided paging, filtering, and sorting. Up to 100 projects can be returned per request.
3784
+ *
3785
+ * The default `sort` is `id` in `ASC`.
3786
+ *
3787
+ * For a detailed list of supported operations, see [Projects: Supported Filters and Sorting](https://dev.wix.com/docs/rest/business-solutions/portfolio/projects/sort-and-filter).
3788
+ * To learn how to query projects, see [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language).
3769
3789
  */
3770
3790
  (options?: QueryProjectsOptions | undefined): ProjectsQueryBuilder;
3771
3791
  }
@@ -3774,7 +3794,7 @@ interface UpdateProjectOrderInCollectionSignature$1 {
3774
3794
  /**
3775
3795
  * Deprecated - please use ProjectsInCollectionsService.UpdateProjectOrderInCollection instead
3776
3796
  * our Client still use it
3777
- * @param - The new sort order of the project in the given collection
3797
+ * @param - Sort order of the project within the specified collection.
3778
3798
  * @deprecated
3779
3799
  */
3780
3800
  (identifiers: UpdateProjectOrderInCollectionIdentifiers$1, sortOrder: number | null): Promise<UpdateProjectOrderInCollectionResponse$1 & UpdateProjectOrderInCollectionResponseNonNullableFields$1>;
@@ -3825,7 +3845,9 @@ declare const updateProjectOrderInCollection$2: MaybeContext<BuildRESTFunction<t
3825
3845
  declare const queryProjectsWithCollectionInfo: MaybeContext<BuildRESTFunction<typeof queryProjectsWithCollectionInfo$1> & typeof queryProjectsWithCollectionInfo$1>;
3826
3846
 
3827
3847
  type _publicOnProjectCreatedType = typeof onProjectCreated$1;
3828
- /** */
3848
+ /**
3849
+ * Triggered when a project is created.
3850
+ */
3829
3851
  declare const onProjectCreated: ReturnType<typeof createEventModule$1<_publicOnProjectCreatedType>>;
3830
3852
 
3831
3853
  type _publicOnProjectUpdatedType = typeof onProjectUpdated$1;
@@ -3833,7 +3855,9 @@ type _publicOnProjectUpdatedType = typeof onProjectUpdated$1;
3833
3855
  declare const onProjectUpdated: ReturnType<typeof createEventModule$1<_publicOnProjectUpdatedType>>;
3834
3856
 
3835
3857
  type _publicOnProjectDeletedType = typeof onProjectDeleted$1;
3836
- /** */
3858
+ /**
3859
+ * Triggered when a project is deleted.
3860
+ */
3837
3861
  declare const onProjectDeleted: ReturnType<typeof createEventModule$1<_publicOnProjectDeletedType>>;
3838
3862
 
3839
3863
  type context$2_App = App;
@@ -3914,62 +3938,67 @@ declare namespace context$2 {
3914
3938
  }
3915
3939
 
3916
3940
  interface ProjectInCollection {
3917
- /** Collection ID */
3941
+ /** Collection ID. */
3918
3942
  collectionId?: string;
3919
- /** Project */
3943
+ /** Project object. */
3920
3944
  project?: Project;
3921
- /** The sort order of the project in the given Collection */
3945
+ /**
3946
+ * Sort order of the project within the specified collection. <br />
3947
+ *
3948
+ * Default: [Epoch](https://www.epoch101.com/) timestamp. <br />
3949
+ */
3922
3950
  sortOrder?: number | null;
3923
3951
  }
3924
- /** Project is the main entity of ProjectsService */
3925
3952
  interface Project extends ProjectCoverOneOf {
3926
- /** project's cover photo */
3953
+ /** Project cover image. */
3927
3954
  coverImage?: Image;
3928
- /** project's cover video */
3955
+ /** Project cover video. */
3929
3956
  coverVideo?: Video;
3930
3957
  /**
3931
- * Project ID
3958
+ * Project ID.
3932
3959
  * @readonly
3933
3960
  */
3934
3961
  _id?: string | null;
3935
3962
  /**
3936
- * Represents the current state of an item. Each time the item is modified, its `revision` changes. for an update operation to succeed, you MUST pass the latest revision
3963
+ * Revision number, which increments by 1 each time the project is updated. To prevent conflicting changes, the existing revision must be passed when updating the project object.
3937
3964
  * @readonly
3938
3965
  */
3939
3966
  revision?: string | null;
3967
+ /** Project title. */
3940
3968
  title?: string | null;
3969
+ /** Project description. */
3941
3970
  description?: string | null;
3942
- /** indicates if the project should be hidden from Portfolio */
3971
+ /** Whether the project is hidden from the portfolio. */
3943
3972
  hidden?: boolean | null;
3944
- /** Collections must exist to be added to a project. Can be created/updated/deleted using [Collection Service](https://dev.wix.com/docs/rest/business-solutions/portfolio/collection) */
3973
+ /** IDs of the collections that include the project. */
3945
3974
  collectionIds?: string[];
3946
- /** Custom project details */
3975
+ /** Project details. */
3947
3976
  details?: ProjectDetail[];
3948
- /** Project's slug */
3977
+ /** Project slug. */
3949
3978
  slug?: string | null;
3950
3979
  /**
3951
- * Represents the time this Project was created
3980
+ * Date and time the project was created.
3952
3981
  * @readonly
3953
3982
  */
3954
3983
  _createdDate?: Date;
3955
3984
  /**
3956
- * Represents the time this Project was last updated
3985
+ * Date and time the project was updated.
3957
3986
  * @readonly
3958
3987
  */
3959
3988
  _updatedDate?: Date;
3960
3989
  /**
3961
- * Url and relative url of Project - in order to receive this field in READ requests you will need to pass the `include_page_url` field as part of request
3990
+ * Project's page URL and relative path. To receive this field in the response, pass the `includePageUrl` query parameter in the request.
3962
3991
  * @readonly
3963
3992
  */
3964
3993
  url?: string;
3965
- /** SEO data for the project */
3994
+ /** Project SEO data. */
3966
3995
  seoData?: SeoSchema;
3967
3996
  }
3968
3997
  /** @oneof */
3969
3998
  interface ProjectCoverOneOf {
3970
- /** project's cover photo */
3999
+ /** Project cover image. */
3971
4000
  coverImage?: Image;
3972
- /** project's cover video */
4001
+ /** Project cover video. */
3973
4002
  coverVideo?: Video;
3974
4003
  }
3975
4004
  interface Image {
@@ -4027,21 +4056,30 @@ interface VideoResolution {
4027
4056
  /** Video filename. */
4028
4057
  filename?: string | null;
4029
4058
  }
4059
+ /**
4060
+ * Project label.
4061
+ * One of:
4062
+ * + `text`
4063
+ * + `link`
4064
+ */
4030
4065
  interface ProjectDetail extends ProjectDetailValueOneOf {
4066
+ /** Project label in plain text format. */
4031
4067
  text?: string;
4032
- /** Details link */
4068
+ /** Project label in link format. */
4033
4069
  link?: DetailsLink;
4034
4070
  label?: string;
4035
4071
  }
4036
4072
  /** @oneof */
4037
4073
  interface ProjectDetailValueOneOf {
4074
+ /** Project label in plain text format. */
4038
4075
  text?: string;
4039
- /** Details link */
4076
+ /** Project label in link format. */
4040
4077
  link?: DetailsLink;
4041
4078
  }
4042
4079
  interface DetailsLink {
4080
+ /** Display text of the link. */
4043
4081
  text?: string | null;
4044
- /** link to external source */
4082
+ /** Target URL of the link. */
4045
4083
  url?: string | null;
4046
4084
  /**
4047
4085
  * Whether the link opens in a new tab or window. One of:
@@ -4126,9 +4164,12 @@ interface Settings {
4126
4164
  keywords?: Keyword[];
4127
4165
  }
4128
4166
  interface QueryProjectInCollectionsRequest {
4129
- /** WQL expression */
4167
+ /** Query options. */
4130
4168
  query: QueryV2;
4131
- /** Include the page URL */
4169
+ /**
4170
+ * Whether to include the project's relative path and full URL in the response.
4171
+ * Default: `false`
4172
+ */
4132
4173
  includePageUrl?: boolean | null;
4133
4174
  }
4134
4175
  interface QueryV2 extends QueryV2PagingMethodOneOf {
@@ -4188,9 +4229,9 @@ interface CursorPaging$1 {
4188
4229
  cursor?: string | null;
4189
4230
  }
4190
4231
  interface QueryProjectInCollectionsResponse {
4191
- /** The retrieved Projects in Collections context */
4232
+ /** List of projects in collections. */
4192
4233
  projectInCollections?: ProjectInCollection[];
4193
- /** Paging metadata */
4234
+ /** Paging metadata. */
4194
4235
  metadata?: PagingMetadataV2$1;
4195
4236
  }
4196
4237
  interface PagingMetadataV2$1 {
@@ -4212,23 +4253,23 @@ interface Cursors$1 {
4212
4253
  prev?: string | null;
4213
4254
  }
4214
4255
  interface UpdateProjectOrderInCollectionRequest {
4215
- /** Id of the Project to update its order */
4256
+ /** ID of the project to update. */
4216
4257
  projectId: string;
4217
- /** Id of the collection in which the project will be re-ordered */
4258
+ /** Collection ID. */
4218
4259
  collectionId: string;
4219
- /** The new sort order of the project in the given collection */
4260
+ /** Sort order of the project within the specified collection. */
4220
4261
  sortOrder: number | null;
4221
4262
  }
4222
4263
  interface UpdateProjectOrderInCollectionResponse {
4223
- /** project with new sort order set */
4264
+ /** Updated project within the specified collection. */
4224
4265
  projectInCollection?: ProjectInCollection;
4225
4266
  }
4226
4267
  interface ProjectOrderInCollectionUpdatedEvent {
4227
- /** Id of the Project to update its order */
4268
+ /** ID of the project to update. */
4228
4269
  projectId?: string;
4229
- /** Id of the collection in which the project will be re-ordered */
4270
+ /** Collection ID. */
4230
4271
  collectionId?: string;
4231
- /** The new sort order of the project in the given collection */
4272
+ /** Sort order of the project within the specified collection. */
4232
4273
  sortOrder?: number | null;
4233
4274
  }
4234
4275
  interface DomainEvent$1 extends DomainEventBodyOneOf$1 {
@@ -4453,7 +4494,10 @@ interface ProjectInCollectionProjectOrderInCollectionUpdatedEnvelope {
4453
4494
  metadata: EventMetadata;
4454
4495
  }
4455
4496
  interface QueryProjectInCollectionsOptions {
4456
- /** Include the page URL */
4497
+ /**
4498
+ * Whether to include the project's relative path and full URL in the response.
4499
+ * Default: `false`
4500
+ */
4457
4501
  includePageUrl?: boolean | null | undefined;
4458
4502
  }
4459
4503
  interface QueryCursorResult {
@@ -4534,30 +4578,30 @@ interface ProjectInCollectionsQueryBuilder {
4534
4578
  find: () => Promise<ProjectInCollectionsQueryResult>;
4535
4579
  }
4536
4580
  interface UpdateProjectOrderInCollectionIdentifiers {
4537
- /** Id of the Project to update its order */
4581
+ /** ID of the project to update. */
4538
4582
  projectId: string;
4539
- /** Id of the collection in which the project will be re-ordered */
4583
+ /** Collection ID. */
4540
4584
  collectionId: string;
4541
4585
  }
4542
4586
 
4543
4587
  declare function queryProjectInCollections$1(httpClient: HttpClient): QueryProjectInCollectionsSignature;
4544
4588
  interface QueryProjectInCollectionsSignature {
4545
4589
  /**
4546
- * Query project in collection context using [WQL - Wix Query Language](https://dev.wix.com/api/rest/getting-started/api-query-language)
4590
+ * Retrieves a list of projects in the specified collections given the provided paging, filtering, and sorting. Up to 100 projects can be returned per request.
4547
4591
  *
4548
- * Because project can be ordered different in each collection, use this when want to query the projects in a Collection ordered by the order in given collection
4592
+ * The default `sort` is `project.id` in `ASC`.
4549
4593
  *
4550
- * Supported Fields for query and ordering: collectionId, project.id, sortOrder, project.hidden, project.slug
4594
+ * For additional field support for filters and sorting, see [Projects In Collections: Supported Filters and Sorting](https://dev.wix.com/docs/rest/business-solutions/portfolio/project-in-collection/sort-and-filter).
4551
4595
  *
4552
- * If you want to Query project by Project properties please use ProjectsService.Query method - link [Query Projects](https://dev.wix.com/docs/rest/business-solutions/portfolio/project-v1/query-projects)
4596
+ * To learn how to query projects in collections, see [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language).
4553
4597
  */
4554
4598
  (options?: QueryProjectInCollectionsOptions | undefined): ProjectInCollectionsQueryBuilder;
4555
4599
  }
4556
4600
  declare function updateProjectOrderInCollection$1(httpClient: HttpClient): UpdateProjectOrderInCollectionSignature;
4557
4601
  interface UpdateProjectOrderInCollectionSignature {
4558
4602
  /**
4559
- * Updates Project's order in a given Collection
4560
- * @param - The new sort order of the project in the given collection
4603
+ * Updates the order of a project within the specified collection.
4604
+ * @param - Sort order of the project within the specified collection.
4561
4605
  */
4562
4606
  (identifiers: UpdateProjectOrderInCollectionIdentifiers, sortOrder: number | null): Promise<UpdateProjectOrderInCollectionResponse & UpdateProjectOrderInCollectionResponseNonNullableFields>;
4563
4607
  }