@wix/autocms-folders-service 1.0.0

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.
@@ -0,0 +1,499 @@
1
+ /**
2
+ * Folder is a container for other folders and collection references
3
+ * There's always 1 root folder with empty ID
4
+ */
5
+ interface Folder$1 {
6
+ /**
7
+ * unique ID, not present for root folder, mandatory for nested folders
8
+ * @readonly
9
+ */
10
+ id?: string | null;
11
+ /** display name */
12
+ displayName?: string;
13
+ /** folder description if any */
14
+ description?: string | null;
15
+ /** additional information */
16
+ info?: Record<string, any> | null;
17
+ /** collections in current folder */
18
+ collections?: CollectionReference$1[];
19
+ /** nested folders */
20
+ folders?: Folder$1[];
21
+ }
22
+ /**
23
+ * Reference to a collection, contained in a folder
24
+ * Collection may have up to 1 reference per folder
25
+ * and exactly 1 non-shortcut reference overall
26
+ */
27
+ interface CollectionReference$1 {
28
+ /** collection unique name (ID) */
29
+ collectionName?: string;
30
+ /**
31
+ * same collection may have many shortcut references across folders
32
+ * but only one non-shortcut reference
33
+ * by default any collection will have reference at root folder
34
+ */
35
+ shortcut?: boolean;
36
+ /** additional information */
37
+ info?: Record<string, any> | null;
38
+ }
39
+ interface GetFolderRequest$1 {
40
+ /** missing means root */
41
+ folderId?: string | null;
42
+ /**
43
+ * nesting depth to return
44
+ * - 0 means no nested elements, only folder details
45
+ * - none means full folder tree
46
+ */
47
+ depth?: number | null;
48
+ /**
49
+ * if true CollectionReference.schema are not returned,
50
+ * but call is much faster.
51
+ * ignored for root folder request
52
+ * @deprecated
53
+ * @targetRemovalDate 2025-01-01
54
+ */
55
+ skipSchemas?: boolean;
56
+ }
57
+ interface GetFolderResponse$1 {
58
+ /** requested folder details */
59
+ folder?: Folder$1;
60
+ /** depth value requested */
61
+ depth?: number | null;
62
+ }
63
+ interface CreateFolderRequest$1 {
64
+ /** parent folder ID or none if root */
65
+ parentFolderId?: string | null;
66
+ /** folder info to create */
67
+ folderInfo?: FolderInfo$1;
68
+ }
69
+ interface FolderInfo$1 {
70
+ /** display name */
71
+ displayName?: string | null;
72
+ /** description */
73
+ description?: string | null;
74
+ /** additional info */
75
+ info?: Record<string, any> | null;
76
+ }
77
+ interface CreateFolderResponse$1 {
78
+ /** parent of created folder or none for root */
79
+ parentFolderId?: string | null;
80
+ /** created folder */
81
+ folder?: Folder$1;
82
+ }
83
+ interface UpdateFolderRequest$1 {
84
+ /** Folder ID */
85
+ folderId: string;
86
+ /** Fields to update, partial */
87
+ folderInfo?: FolderInfo$1;
88
+ }
89
+ interface UpdateFolderResponse$1 {
90
+ /**
91
+ * updated folder
92
+ * folder contents (folders and collections) would not be returned
93
+ */
94
+ folder?: Folder$1;
95
+ }
96
+ interface DeleteFolderRequest$1 {
97
+ /** folder ID to delete */
98
+ folderId: string;
99
+ }
100
+ interface DeleteFolderResponse$1 {
101
+ }
102
+ interface MoveFolderRequest$1 {
103
+ /** folder ID to move */
104
+ folderId: string;
105
+ /** destination folder ID (new parent), none if root */
106
+ parentFolderId?: string | null;
107
+ }
108
+ interface MoveFolderResponse$1 {
109
+ }
110
+ interface ReferenceCollectionRequest$1 {
111
+ /** collection name to reference (ID) */
112
+ collectionName: string;
113
+ /** target folder ID or none if root */
114
+ folderId?: string | null;
115
+ /**
116
+ * if false then single non-shortcut reference to this
117
+ * collection is moved to target folder
118
+ * otherwise new shortcut reference is created
119
+ */
120
+ shortcut?: boolean;
121
+ /**
122
+ * additional information for shortcut reference
123
+ * ignored for non-shortcut reference
124
+ */
125
+ info?: Record<string, any> | null;
126
+ }
127
+ interface ReferenceCollectionResponse$1 {
128
+ /** Folder ID that contains reference or none if root */
129
+ folderId?: string | null;
130
+ /** reference details */
131
+ collectionReference?: CollectionReference$1;
132
+ }
133
+ interface GetReferencesRequest$1 {
134
+ /** collection name (ID) to get */
135
+ collectionName: string;
136
+ /**
137
+ * if true schema would not be loaded and reference may not be found if collection is in root folder
138
+ * loading schema has performance impact
139
+ * @deprecated
140
+ * @targetRemovalDate 2025-01-01
141
+ */
142
+ skipSchemas?: boolean;
143
+ }
144
+ interface GetReferencesResponse$1 {
145
+ /** list of references */
146
+ references?: ReferenceLocation$1[];
147
+ }
148
+ interface ReferenceLocation$1 {
149
+ /** folder where reference is located */
150
+ folderId?: string | null;
151
+ /** reference details */
152
+ reference?: CollectionReference$1;
153
+ }
154
+ interface UpdateReferenceInfoRequest$1 {
155
+ /** folder where reference is located, none for root */
156
+ folderId?: string | null;
157
+ /** referenced collection name (ID) */
158
+ collectionName: string;
159
+ /** additional information to set */
160
+ info?: Record<string, any> | null;
161
+ }
162
+ interface UpdateReferenceInfoResponse$1 {
163
+ /** Folder ID that contains reference or none if root */
164
+ folderId?: string | null;
165
+ /** reference details */
166
+ collectionReference?: CollectionReference$1;
167
+ }
168
+ interface DeleteReferenceRequest$1 {
169
+ /** collection name (ID) to delete */
170
+ collectionName: string;
171
+ /** folder ID where to delete reference or none if root */
172
+ folderId?: string | null;
173
+ }
174
+ interface DeleteReferenceResponse$1 {
175
+ }
176
+ interface SearchRequest$1 {
177
+ /** Search string, matched ignoring case */
178
+ searchTerm?: string;
179
+ }
180
+ interface SearchResponse$1 {
181
+ /** folders found, no contents are returned */
182
+ folders?: Folder$1[];
183
+ /**
184
+ * collections found
185
+ * @deprecated
186
+ * @replacedBy references
187
+ * @targetRemovalDate 2025-01-01
188
+ */
189
+ collections?: CollectionReference$1[];
190
+ /** collection references found */
191
+ references?: ReferenceLocation$1[];
192
+ }
193
+ interface CollectionReferenceNonNullableFields$1 {
194
+ collectionName: string;
195
+ shortcut: boolean;
196
+ }
197
+ interface FolderNonNullableFields$1 {
198
+ displayName: string;
199
+ collections: CollectionReferenceNonNullableFields$1[];
200
+ folders: FolderNonNullableFields$1[];
201
+ }
202
+ interface GetFolderResponseNonNullableFields$1 {
203
+ folder?: FolderNonNullableFields$1;
204
+ }
205
+ interface CreateFolderResponseNonNullableFields$1 {
206
+ folder?: FolderNonNullableFields$1;
207
+ }
208
+ interface UpdateFolderResponseNonNullableFields$1 {
209
+ folder?: FolderNonNullableFields$1;
210
+ }
211
+ interface ReferenceCollectionResponseNonNullableFields$1 {
212
+ collectionReference?: CollectionReferenceNonNullableFields$1;
213
+ }
214
+ interface ReferenceLocationNonNullableFields$1 {
215
+ reference?: CollectionReferenceNonNullableFields$1;
216
+ }
217
+ interface GetReferencesResponseNonNullableFields$1 {
218
+ references: ReferenceLocationNonNullableFields$1[];
219
+ }
220
+ interface UpdateReferenceInfoResponseNonNullableFields$1 {
221
+ collectionReference?: CollectionReferenceNonNullableFields$1;
222
+ }
223
+ interface SearchResponseNonNullableFields$1 {
224
+ folders: FolderNonNullableFields$1[];
225
+ collections: CollectionReferenceNonNullableFields$1[];
226
+ references: ReferenceLocationNonNullableFields$1[];
227
+ }
228
+
229
+ /**
230
+ * Folder is a container for other folders and collection references
231
+ * There's always 1 root folder with empty ID
232
+ */
233
+ interface Folder {
234
+ /**
235
+ * unique ID, not present for root folder, mandatory for nested folders
236
+ * @readonly
237
+ */
238
+ _id?: string | null;
239
+ /** display name */
240
+ displayName?: string;
241
+ /** folder description if any */
242
+ description?: string | null;
243
+ /** additional information */
244
+ info?: Record<string, any> | null;
245
+ /** collections in current folder */
246
+ collections?: CollectionReference[];
247
+ /** nested folders */
248
+ folders?: Folder[];
249
+ }
250
+ /**
251
+ * Reference to a collection, contained in a folder
252
+ * Collection may have up to 1 reference per folder
253
+ * and exactly 1 non-shortcut reference overall
254
+ */
255
+ interface CollectionReference {
256
+ /** collection unique name (ID) */
257
+ collectionName?: string;
258
+ /**
259
+ * same collection may have many shortcut references across folders
260
+ * but only one non-shortcut reference
261
+ * by default any collection will have reference at root folder
262
+ */
263
+ shortcut?: boolean;
264
+ /** additional information */
265
+ info?: Record<string, any> | null;
266
+ }
267
+ interface GetFolderRequest {
268
+ /** missing means root */
269
+ folderId?: string | null;
270
+ /**
271
+ * nesting depth to return
272
+ * - 0 means no nested elements, only folder details
273
+ * - none means full folder tree
274
+ */
275
+ depth?: number | null;
276
+ /**
277
+ * if true CollectionReference.schema are not returned,
278
+ * but call is much faster.
279
+ * ignored for root folder request
280
+ * @deprecated
281
+ * @targetRemovalDate 2025-01-01
282
+ */
283
+ skipSchemas?: boolean;
284
+ }
285
+ interface GetFolderResponse {
286
+ /** requested folder details */
287
+ folder?: Folder;
288
+ /** depth value requested */
289
+ depth?: number | null;
290
+ }
291
+ interface CreateFolderRequest {
292
+ /** parent folder ID or none if root */
293
+ parentFolderId?: string | null;
294
+ /** folder info to create */
295
+ folderInfo?: FolderInfo;
296
+ }
297
+ interface FolderInfo {
298
+ /** display name */
299
+ displayName?: string | null;
300
+ /** description */
301
+ description?: string | null;
302
+ /** additional info */
303
+ info?: Record<string, any> | null;
304
+ }
305
+ interface CreateFolderResponse {
306
+ /** parent of created folder or none for root */
307
+ parentFolderId?: string | null;
308
+ /** created folder */
309
+ folder?: Folder;
310
+ }
311
+ interface UpdateFolderRequest {
312
+ /** Folder ID */
313
+ folderId: string;
314
+ /** Fields to update, partial */
315
+ folderInfo?: FolderInfo;
316
+ }
317
+ interface UpdateFolderResponse {
318
+ /**
319
+ * updated folder
320
+ * folder contents (folders and collections) would not be returned
321
+ */
322
+ folder?: Folder;
323
+ }
324
+ interface DeleteFolderRequest {
325
+ /** folder ID to delete */
326
+ folderId: string;
327
+ }
328
+ interface DeleteFolderResponse {
329
+ }
330
+ interface MoveFolderRequest {
331
+ /** folder ID to move */
332
+ folderId: string;
333
+ /** destination folder ID (new parent), none if root */
334
+ parentFolderId?: string | null;
335
+ }
336
+ interface MoveFolderResponse {
337
+ }
338
+ interface ReferenceCollectionRequest {
339
+ /** collection name to reference (ID) */
340
+ collectionName: string;
341
+ /** target folder ID or none if root */
342
+ folderId?: string | null;
343
+ /**
344
+ * if false then single non-shortcut reference to this
345
+ * collection is moved to target folder
346
+ * otherwise new shortcut reference is created
347
+ */
348
+ shortcut?: boolean;
349
+ /**
350
+ * additional information for shortcut reference
351
+ * ignored for non-shortcut reference
352
+ */
353
+ info?: Record<string, any> | null;
354
+ }
355
+ interface ReferenceCollectionResponse {
356
+ /** Folder ID that contains reference or none if root */
357
+ folderId?: string | null;
358
+ /** reference details */
359
+ collectionReference?: CollectionReference;
360
+ }
361
+ interface GetReferencesRequest {
362
+ /** collection name (ID) to get */
363
+ collectionName: string;
364
+ /**
365
+ * if true schema would not be loaded and reference may not be found if collection is in root folder
366
+ * loading schema has performance impact
367
+ * @deprecated
368
+ * @targetRemovalDate 2025-01-01
369
+ */
370
+ skipSchemas?: boolean;
371
+ }
372
+ interface GetReferencesResponse {
373
+ /** list of references */
374
+ references?: ReferenceLocation[];
375
+ }
376
+ interface ReferenceLocation {
377
+ /** folder where reference is located */
378
+ folderId?: string | null;
379
+ /** reference details */
380
+ reference?: CollectionReference;
381
+ }
382
+ interface UpdateReferenceInfoRequest {
383
+ /** folder where reference is located, none for root */
384
+ folderId?: string | null;
385
+ /** referenced collection name (ID) */
386
+ collectionName: string;
387
+ /** additional information to set */
388
+ info?: Record<string, any> | null;
389
+ }
390
+ interface UpdateReferenceInfoResponse {
391
+ /** Folder ID that contains reference or none if root */
392
+ folderId?: string | null;
393
+ /** reference details */
394
+ collectionReference?: CollectionReference;
395
+ }
396
+ interface DeleteReferenceRequest {
397
+ /** collection name (ID) to delete */
398
+ collectionName: string;
399
+ /** folder ID where to delete reference or none if root */
400
+ folderId?: string | null;
401
+ }
402
+ interface DeleteReferenceResponse {
403
+ }
404
+ interface SearchRequest {
405
+ /** Search string, matched ignoring case */
406
+ searchTerm?: string;
407
+ }
408
+ interface SearchResponse {
409
+ /** folders found, no contents are returned */
410
+ folders?: Folder[];
411
+ /**
412
+ * collections found
413
+ * @deprecated
414
+ * @replacedBy references
415
+ * @targetRemovalDate 2025-01-01
416
+ */
417
+ collections?: CollectionReference[];
418
+ /** collection references found */
419
+ references?: ReferenceLocation[];
420
+ }
421
+ interface CollectionReferenceNonNullableFields {
422
+ collectionName: string;
423
+ shortcut: boolean;
424
+ }
425
+ interface FolderNonNullableFields {
426
+ displayName: string;
427
+ collections: CollectionReferenceNonNullableFields[];
428
+ folders: FolderNonNullableFields[];
429
+ }
430
+ interface GetFolderResponseNonNullableFields {
431
+ folder?: FolderNonNullableFields;
432
+ }
433
+ interface CreateFolderResponseNonNullableFields {
434
+ folder?: FolderNonNullableFields;
435
+ }
436
+ interface UpdateFolderResponseNonNullableFields {
437
+ folder?: FolderNonNullableFields;
438
+ }
439
+ interface ReferenceCollectionResponseNonNullableFields {
440
+ collectionReference?: CollectionReferenceNonNullableFields;
441
+ }
442
+ interface ReferenceLocationNonNullableFields {
443
+ reference?: CollectionReferenceNonNullableFields;
444
+ }
445
+ interface GetReferencesResponseNonNullableFields {
446
+ references: ReferenceLocationNonNullableFields[];
447
+ }
448
+ interface UpdateReferenceInfoResponseNonNullableFields {
449
+ collectionReference?: CollectionReferenceNonNullableFields;
450
+ }
451
+ interface SearchResponseNonNullableFields {
452
+ folders: FolderNonNullableFields[];
453
+ collections: CollectionReferenceNonNullableFields[];
454
+ references: ReferenceLocationNonNullableFields[];
455
+ }
456
+
457
+ type __PublicMethodMetaInfo<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = {
458
+ getUrl: (context: any) => string;
459
+ httpMethod: K;
460
+ path: string;
461
+ pathParams: M;
462
+ __requestType: T;
463
+ __originalRequestType: S;
464
+ __responseType: Q;
465
+ __originalResponseType: R;
466
+ };
467
+ declare function getFolder(): __PublicMethodMetaInfo<'GET', {}, GetFolderRequest, GetFolderRequest$1, GetFolderResponse & GetFolderResponseNonNullableFields, GetFolderResponse$1 & GetFolderResponseNonNullableFields$1>;
468
+ declare function createFolder(): __PublicMethodMetaInfo<'POST', {}, CreateFolderRequest, CreateFolderRequest$1, CreateFolderResponse & CreateFolderResponseNonNullableFields, CreateFolderResponse$1 & CreateFolderResponseNonNullableFields$1>;
469
+ declare function updateFolder(): __PublicMethodMetaInfo<'PATCH', {
470
+ folderId: string;
471
+ }, UpdateFolderRequest, UpdateFolderRequest$1, UpdateFolderResponse & UpdateFolderResponseNonNullableFields, UpdateFolderResponse$1 & UpdateFolderResponseNonNullableFields$1>;
472
+ declare function deleteFolder(): __PublicMethodMetaInfo<'DELETE', {
473
+ folderId: string;
474
+ }, DeleteFolderRequest, DeleteFolderRequest$1, DeleteFolderResponse, DeleteFolderResponse$1>;
475
+ declare function moveFolder(): __PublicMethodMetaInfo<'POST', {
476
+ folderId: string;
477
+ }, MoveFolderRequest, MoveFolderRequest$1, MoveFolderResponse, MoveFolderResponse$1>;
478
+ declare function referenceCollection(): __PublicMethodMetaInfo<'POST', {}, ReferenceCollectionRequest, ReferenceCollectionRequest$1, ReferenceCollectionResponse & ReferenceCollectionResponseNonNullableFields, ReferenceCollectionResponse$1 & ReferenceCollectionResponseNonNullableFields$1>;
479
+ declare function getReferences(): __PublicMethodMetaInfo<'POST', {}, GetReferencesRequest, GetReferencesRequest$1, GetReferencesResponse & GetReferencesResponseNonNullableFields, GetReferencesResponse$1 & GetReferencesResponseNonNullableFields$1>;
480
+ declare function updateReferenceInfo(): __PublicMethodMetaInfo<'POST', {}, UpdateReferenceInfoRequest, UpdateReferenceInfoRequest$1, UpdateReferenceInfoResponse & UpdateReferenceInfoResponseNonNullableFields, UpdateReferenceInfoResponse$1 & UpdateReferenceInfoResponseNonNullableFields$1>;
481
+ declare function deleteReference(): __PublicMethodMetaInfo<'POST', {}, DeleteReferenceRequest, DeleteReferenceRequest$1, DeleteReferenceResponse, DeleteReferenceResponse$1>;
482
+ declare function search(): __PublicMethodMetaInfo<'POST', {}, SearchRequest, SearchRequest$1, SearchResponse & SearchResponseNonNullableFields, SearchResponse$1 & SearchResponseNonNullableFields$1>;
483
+
484
+ type meta___PublicMethodMetaInfo<K = string, M = unknown, T = unknown, S = unknown, Q = unknown, R = unknown> = __PublicMethodMetaInfo<K, M, T, S, Q, R>;
485
+ declare const meta_createFolder: typeof createFolder;
486
+ declare const meta_deleteFolder: typeof deleteFolder;
487
+ declare const meta_deleteReference: typeof deleteReference;
488
+ declare const meta_getFolder: typeof getFolder;
489
+ declare const meta_getReferences: typeof getReferences;
490
+ declare const meta_moveFolder: typeof moveFolder;
491
+ declare const meta_referenceCollection: typeof referenceCollection;
492
+ declare const meta_search: typeof search;
493
+ declare const meta_updateFolder: typeof updateFolder;
494
+ declare const meta_updateReferenceInfo: typeof updateReferenceInfo;
495
+ declare namespace meta {
496
+ export { type meta___PublicMethodMetaInfo as __PublicMethodMetaInfo, meta_createFolder as createFolder, meta_deleteFolder as deleteFolder, meta_deleteReference as deleteReference, meta_getFolder as getFolder, meta_getReferences as getReferences, meta_moveFolder as moveFolder, meta_referenceCollection as referenceCollection, meta_search as search, meta_updateFolder as updateFolder, meta_updateReferenceInfo as updateReferenceInfo };
497
+ }
498
+
499
+ export { meta as autocms };