@wix/autocms-collection-metadata-service 1.0.3 → 1.0.5

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.
@@ -1,16 +1,16 @@
1
- /** CollectionMetadata contains CM-specific metadata for a collection */
1
+ /** Contains the CMS metadata for the given collection. */
2
2
  interface CollectionMetadata$1 {
3
- /** ID of data collection */
3
+ /** ID of the associated data collection. */
4
4
  dataCollectionId?: string;
5
- /** active named view */
5
+ /** ID of the active named (custom) view. Learn more about [creating custom collection views](https://support.wix.com/en/article/cms-creating-custom-collection-views) in the CMS. */
6
6
  activeNamedViewId?: string | null;
7
- /** if table view should be hidden */
7
+ /** Whether to [hide the table layout view](https://support.wix.com/en/article/cms-setting-field-validations-in-your-collections#hiding-the-table-layout-to-prevent-empty-required-fields). Default: `false`. */
8
8
  hideTableView?: boolean | null;
9
- /** named views */
9
+ /** List of [custom collection views](https://support.wix.com/en/article/cms-creating-custom-collection-views). */
10
10
  namedViews?: Record<string, any>[] | null;
11
- /** named view ID used for default site sort in datasets */
11
+ /** Custom view to mirror on the Wix site. Learn more about [mirroring item order to the site's connected elements](https://support.wix.com/en/article/cms-mirroring-the-order-of-items-in-your-collection-to-your-sites-connected-elements). */
12
12
  namedViewIdForSiteSort?: string | null;
13
- /** Type of data permissions template used initially */
13
+ /** Collection permission template. Each collection has a permissions template that determines what Learn more about [collection permissions](https://support.wix.com/en/article/cms-changing-your-collection-permissions). */
14
14
  permissionsTemplate?: PermissionsTemplateType$1;
15
15
  }
16
16
  declare enum PermissionsTemplateType$1 {
@@ -20,48 +20,51 @@ declare enum PermissionsTemplateType$1 {
20
20
  CUSTOM = "CUSTOM"
21
21
  }
22
22
  interface CreateCollectionMetadataRequest$1 {
23
- /** CollectionMetadata to be created */
23
+ /** Collection metadata details. */
24
24
  collectionMetadata: CollectionMetadata$1;
25
25
  }
26
26
  interface CreateCollectionMetadataResponse$1 {
27
- /** The created CollectionMetadata */
27
+ /** Created collection metadata instance. */
28
28
  collectionMetadata?: CollectionMetadata$1;
29
29
  }
30
30
  interface GetCollectionMetadataRequest$1 {
31
- /** Id of collection to retrieve metadata for */
31
+ /** ID of the collection for which to retrieve metadata. */
32
32
  dataCollectionId?: string;
33
33
  }
34
34
  interface GetCollectionMetadataResponse$1 {
35
- /** The retrieved CollectionMetadata */
35
+ /** Retrieved collection metadata instance. */
36
36
  collectionMetadata?: CollectionMetadata$1;
37
37
  }
38
38
  interface UpdateCollectionMetadataRequest$1 {
39
39
  /**
40
- * ID of metadata to update, ignored if collection_metadata.data_collection_id is non-empty
40
+ * TODO CLARIFY WHAT THIS MEANS:
41
+ * ID of metadata to update, ignored if **collection_metadata.data_collection_id** is non-empty // a technical workaround
41
42
  * exists because of docs generation issue with nested fields and ** path variables
43
+ * TODO shouldn't this be required? // Yes
44
+ * ID of the collection for which to update metadata.
42
45
  */
43
46
  dataCollectionId?: string;
44
- /** CollectionMetadata to be updated, may be partial */
47
+ /** Collection metadata to update. Only the specified fields are affected. Fields not mentioned remain unchanged. */
45
48
  collectionMetadata: CollectionMetadata$1;
46
49
  }
47
50
  interface UpdateCollectionMetadataResponse$1 {
48
- /** The updated CollectionMetadata */
51
+ /** Updated collection metadata instance. */
49
52
  collectionMetadata?: CollectionMetadata$1;
50
53
  }
51
54
  interface ReplaceCollectionMetadataRequest$1 {
52
- /** The updated CollectionMetadatas */
55
+ /** Collection metadata to replace existing metadata. */
53
56
  items?: CollectionMetadata$1[];
54
57
  }
55
58
  interface ReplaceCollectionMetadataResponse$1 {
56
59
  }
57
60
  interface DeleteCollectionMetadataRequest$1 {
58
- /** Id of collection to delete metadata for */
61
+ /** ID of the collection for which to delete metadata. */
59
62
  dataCollectionId?: string;
60
63
  }
61
64
  interface DeleteCollectionMetadataResponse$1 {
62
65
  }
63
66
  interface ListCollectionMetadataRequest$1 {
64
- /** paging info */
67
+ /** Paging settings. */
65
68
  paging?: CursorPaging$1;
66
69
  }
67
70
  interface CursorPaging$1 {
@@ -76,9 +79,9 @@ interface CursorPaging$1 {
76
79
  cursor?: string | null;
77
80
  }
78
81
  interface ListCollectionMetadataResponse$1 {
79
- /** The retrieved CollectionMetadatas */
82
+ /** List of collection metadata instances. */
80
83
  items?: CollectionMetadata$1[];
81
- /** paging metadata */
84
+ /** Paging information. */
82
85
  pagingMetadata?: CursorPagingMetadata$1;
83
86
  }
84
87
  interface CursorPagingMetadata$1 {
@@ -117,19 +120,19 @@ interface ListCollectionMetadataResponseNonNullableFields$1 {
117
120
  items: CollectionMetadataNonNullableFields$1[];
118
121
  }
119
122
 
120
- /** CollectionMetadata contains CM-specific metadata for a collection */
123
+ /** Contains the CMS metadata for the given collection. */
121
124
  interface CollectionMetadata {
122
- /** ID of data collection */
125
+ /** ID of the associated data collection. */
123
126
  dataCollectionId?: string;
124
- /** active named view */
127
+ /** ID of the active named (custom) view. Learn more about [creating custom collection views](https://support.wix.com/en/article/cms-creating-custom-collection-views) in the CMS. */
125
128
  activeNamedViewId?: string | null;
126
- /** if table view should be hidden */
129
+ /** Whether to [hide the table layout view](https://support.wix.com/en/article/cms-setting-field-validations-in-your-collections#hiding-the-table-layout-to-prevent-empty-required-fields). Default: `false`. */
127
130
  hideTableView?: boolean | null;
128
- /** named views */
131
+ /** List of [custom collection views](https://support.wix.com/en/article/cms-creating-custom-collection-views). */
129
132
  namedViews?: Record<string, any>[] | null;
130
- /** named view ID used for default site sort in datasets */
133
+ /** Custom view to mirror on the Wix site. Learn more about [mirroring item order to the site's connected elements](https://support.wix.com/en/article/cms-mirroring-the-order-of-items-in-your-collection-to-your-sites-connected-elements). */
131
134
  namedViewIdForSiteSort?: string | null;
132
- /** Type of data permissions template used initially */
135
+ /** Collection permission template. Each collection has a permissions template that determines what Learn more about [collection permissions](https://support.wix.com/en/article/cms-changing-your-collection-permissions). */
133
136
  permissionsTemplate?: PermissionsTemplateType;
134
137
  }
135
138
  declare enum PermissionsTemplateType {
@@ -139,48 +142,51 @@ declare enum PermissionsTemplateType {
139
142
  CUSTOM = "CUSTOM"
140
143
  }
141
144
  interface CreateCollectionMetadataRequest {
142
- /** CollectionMetadata to be created */
145
+ /** Collection metadata details. */
143
146
  collectionMetadata: CollectionMetadata;
144
147
  }
145
148
  interface CreateCollectionMetadataResponse {
146
- /** The created CollectionMetadata */
149
+ /** Created collection metadata instance. */
147
150
  collectionMetadata?: CollectionMetadata;
148
151
  }
149
152
  interface GetCollectionMetadataRequest {
150
- /** Id of collection to retrieve metadata for */
153
+ /** ID of the collection for which to retrieve metadata. */
151
154
  dataCollectionId?: string;
152
155
  }
153
156
  interface GetCollectionMetadataResponse {
154
- /** The retrieved CollectionMetadata */
157
+ /** Retrieved collection metadata instance. */
155
158
  collectionMetadata?: CollectionMetadata;
156
159
  }
157
160
  interface UpdateCollectionMetadataRequest {
158
161
  /**
159
- * ID of metadata to update, ignored if collection_metadata.data_collection_id is non-empty
162
+ * TODO CLARIFY WHAT THIS MEANS:
163
+ * ID of metadata to update, ignored if **collection_metadata.data_collection_id** is non-empty // a technical workaround
160
164
  * exists because of docs generation issue with nested fields and ** path variables
165
+ * TODO shouldn't this be required? // Yes
166
+ * ID of the collection for which to update metadata.
161
167
  */
162
168
  dataCollectionId?: string;
163
- /** CollectionMetadata to be updated, may be partial */
169
+ /** Collection metadata to update. Only the specified fields are affected. Fields not mentioned remain unchanged. */
164
170
  collectionMetadata: CollectionMetadata;
165
171
  }
166
172
  interface UpdateCollectionMetadataResponse {
167
- /** The updated CollectionMetadata */
173
+ /** Updated collection metadata instance. */
168
174
  collectionMetadata?: CollectionMetadata;
169
175
  }
170
176
  interface ReplaceCollectionMetadataRequest {
171
- /** The updated CollectionMetadatas */
177
+ /** Collection metadata to replace existing metadata. */
172
178
  items?: CollectionMetadata[];
173
179
  }
174
180
  interface ReplaceCollectionMetadataResponse {
175
181
  }
176
182
  interface DeleteCollectionMetadataRequest {
177
- /** Id of collection to delete metadata for */
183
+ /** ID of the collection for which to delete metadata. */
178
184
  dataCollectionId?: string;
179
185
  }
180
186
  interface DeleteCollectionMetadataResponse {
181
187
  }
182
188
  interface ListCollectionMetadataRequest {
183
- /** paging info */
189
+ /** Paging settings. */
184
190
  paging?: CursorPaging;
185
191
  }
186
192
  interface CursorPaging {
@@ -195,9 +201,9 @@ interface CursorPaging {
195
201
  cursor?: string | null;
196
202
  }
197
203
  interface ListCollectionMetadataResponse {
198
- /** The retrieved CollectionMetadatas */
204
+ /** List of collection metadata instances. */
199
205
  items?: CollectionMetadata[];
200
- /** paging metadata */
206
+ /** Paging information. */
201
207
  pagingMetadata?: CursorPagingMetadata;
202
208
  }
203
209
  interface CursorPagingMetadata {