@wix/auto_sdk_blog_categories 1.0.0 → 1.0.2

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,7 +1,14 @@
1
1
  export interface Category {
2
- /** Category ID. */
2
+ /**
3
+ * Category ID.
4
+ * @immutable
5
+ * @maxLength 38
6
+ */
3
7
  id?: string;
4
- /** Category label. Displayed in the Category Menu. */
8
+ /**
9
+ * Category label. Displayed in the Category Menu.
10
+ * @maxLength 35
11
+ */
5
12
  label?: string;
6
13
  /**
7
14
  * Number of posts in the category.
@@ -13,10 +20,14 @@ export interface Category {
13
20
  * @readonly
14
21
  */
15
22
  url?: PageUrl;
16
- /** Category description. */
23
+ /**
24
+ * Category description.
25
+ * @maxLength 500
26
+ */
17
27
  description?: string | null;
18
28
  /**
19
29
  * Category title.
30
+ * @maxLength 200
20
31
  * @deprecated Category title.
21
32
  * @targetRemovalDate 2025-07-16
22
33
  */
@@ -28,19 +39,27 @@ export interface Category {
28
39
  * Default: `-1`
29
40
  */
30
41
  displayPosition?: number | null;
31
- /** ID of the category's translations. All translations of a single category share the same `translationId`. */
42
+ /**
43
+ * ID of the category's translations. All translations of a single category share the same `translationId`.
44
+ * @format GUID
45
+ */
32
46
  translationId?: string | null;
33
47
  /**
34
48
  * Category language.
35
49
  *
36
50
  * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
51
+ * @immutable
37
52
  */
38
53
  language?: string | null;
39
- /** Part of a category's URL that refers to a specific category. For example, the slug of `https:/example.com/blog/category/famous-cats` is `famous-cats`. */
54
+ /**
55
+ * Part of a category's URL that refers to a specific category. For example, the slug of `https:/example.com/blog/category/famous-cats` is `famous-cats`.
56
+ * @maxLength 100
57
+ */
40
58
  slug?: string;
41
59
  /**
42
60
  * Reserved for internal use.
43
61
  * @readonly
62
+ * @maxLength 24
44
63
  */
45
64
  internalId?: string | null;
46
65
  /** SEO data. */
@@ -75,7 +94,10 @@ export interface Keyword {
75
94
  term?: string;
76
95
  /** Whether the keyword is the main focus keyword. */
77
96
  isMain?: boolean;
78
- /** The source that added the keyword terms to the SEO settings. */
97
+ /**
98
+ * The source that added the keyword terms to the SEO settings.
99
+ * @maxLength 1000
100
+ */
79
101
  origin?: string | null;
80
102
  }
81
103
  export interface Tag {
@@ -108,7 +130,10 @@ export interface Settings {
108
130
  * Default: `false` (Auto Redirect is enabled.)
109
131
  */
110
132
  preventAutoRedirect?: boolean;
111
- /** User-selected keyword terms for a specific page. */
133
+ /**
134
+ * User-selected keyword terms for a specific page.
135
+ * @maxSize 5
136
+ */
112
137
  keywords?: Keyword[];
113
138
  }
114
139
  export interface Image {
@@ -145,11 +170,20 @@ export interface FocalPoint {
145
170
  width?: number | null;
146
171
  }
147
172
  export interface CategoryTranslation {
148
- /** Category ID. */
173
+ /**
174
+ * Category ID.
175
+ * @format GUID
176
+ */
149
177
  id?: string;
150
- /** Label displayed in the categories menu on the site. */
178
+ /**
179
+ * Label displayed in the categories menu on the site.
180
+ * @maxLength 100
181
+ */
151
182
  label?: string | null;
152
- /** Language of the category. */
183
+ /**
184
+ * Language of the category.
185
+ * @format LANGUAGE_TAG
186
+ */
153
187
  language?: string | null;
154
188
  /** URL of this category page. */
155
189
  url?: PageUrl;
@@ -167,6 +201,7 @@ export interface CreateCategoryRequest {
167
201
  *
168
202
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
169
203
  * retrieve the url field in the response in addition to the category’s base fields.
204
+ * @maxSize 10
170
205
  */
171
206
  fieldsets?: Field[];
172
207
  }
@@ -187,7 +222,11 @@ export interface CreateCategoryResponse {
187
222
  category?: Category;
188
223
  }
189
224
  export interface BulkCreateCategoriesRequest {
190
- /** Categories to create. */
225
+ /**
226
+ * Categories to create.
227
+ * @minSize 1
228
+ * @maxSize 50
229
+ */
191
230
  categories?: Category[];
192
231
  /** Whether to return the full created category entities in the response. */
193
232
  returnFullEntity?: boolean;
@@ -197,6 +236,7 @@ export interface BulkCreateCategoriesRequest {
197
236
  *
198
237
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
199
238
  * retrieve the url field in the response in addition to the category’s base fields.
239
+ * @maxSize 10
200
240
  */
201
241
  fieldsets?: Field[];
202
242
  }
@@ -239,7 +279,11 @@ export interface BulkActionMetadata {
239
279
  undetailedFailures?: number;
240
280
  }
241
281
  export interface BulkUpdateCategoriesRequest {
242
- /** Categories to update. */
282
+ /**
283
+ * Categories to update.
284
+ * @minSize 1
285
+ * @maxSize 100
286
+ */
243
287
  categories?: MaskedCategory[];
244
288
  /** Whether to return the full created category entities in the response. */
245
289
  returnFullEntity?: boolean;
@@ -249,6 +293,7 @@ export interface BulkUpdateCategoriesRequest {
249
293
  *
250
294
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
251
295
  * retrieve the url field in the response in addition to the category’s base fields.
296
+ * @maxSize 10
252
297
  */
253
298
  fieldsets?: Field[];
254
299
  }
@@ -273,6 +318,7 @@ export interface UpdateCategoryRequest {
273
318
  *
274
319
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
275
320
  * retrieve the url field in the response in addition to the category’s base fields.
321
+ * @maxSize 10
276
322
  */
277
323
  fieldsets?: Field[];
278
324
  }
@@ -287,13 +333,20 @@ export interface GetCategoriesCountByLanguageResponse {
287
333
  categoriesLanguageCount?: CategoryLanguageCount[];
288
334
  }
289
335
  export interface CategoryLanguageCount {
290
- /** 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format. */
336
+ /**
337
+ * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
338
+ * @format LANGUAGE_TAG
339
+ */
291
340
  languageCode?: string | null;
292
341
  /** The count of Categories for the language. */
293
342
  categoryCount?: number | null;
294
343
  }
295
344
  export interface GetCategoryRequest {
296
- /** Category ID. */
345
+ /**
346
+ * Category ID.
347
+ * @minLength 1
348
+ * @maxLength 38
349
+ */
297
350
  categoryId: string;
298
351
  /**
299
352
  * List of additional category fields to include in the response. By default
@@ -301,6 +354,7 @@ export interface GetCategoryRequest {
301
354
  *
302
355
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
303
356
  * retrieve the url field in the response in addition to the category’s base fields.
357
+ * @maxSize 10
304
358
  */
305
359
  fieldsets?: Field[];
306
360
  }
@@ -309,7 +363,11 @@ export interface GetCategoryResponse {
309
363
  category?: Category;
310
364
  }
311
365
  export interface GetCategoryBySlugRequest {
312
- /** Slug of the category to retrieve. */
366
+ /**
367
+ * Slug of the category to retrieve.
368
+ * @minLength 1
369
+ * @maxLength 100
370
+ */
313
371
  slug: string;
314
372
  /**
315
373
  * List of additional category fields to include in the response. By default
@@ -317,11 +375,13 @@ export interface GetCategoryBySlugRequest {
317
375
  *
318
376
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
319
377
  * retrieve the url field in the response in addition to the category’s base fields.
378
+ * @maxSize 10
320
379
  */
321
380
  fieldsets?: Field[];
322
381
  /**
323
382
  * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
324
383
  * Language of the category to retrieve.
384
+ * @format LANGUAGE_TAG
325
385
  */
326
386
  language?: string | null;
327
387
  }
@@ -338,6 +398,7 @@ export interface ListCategoriesRequest {
338
398
  *
339
399
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
340
400
  * retrieve the url field in the response in addition to the category’s base fields.
401
+ * @maxSize 10
341
402
  */
342
403
  fieldsets?: Field[];
343
404
  /**
@@ -346,6 +407,7 @@ export interface ListCategoriesRequest {
346
407
  * 2-or-4-letter language code in [IETF BCP 47 language tag](https://en.wikipedia.org/wiki/IETF_language_tag) format.
347
408
  * Pass a language to only receive categories that are in that language.
348
409
  * If omitted, categories in all languages are returned.
410
+ * @format LANGUAGE_TAG
349
411
  */
350
412
  language?: string | null;
351
413
  }
@@ -362,9 +424,14 @@ export interface BlogPaging {
362
424
  *
363
425
  *
364
426
  * Default:`50`
427
+ * @min 1
428
+ * @max 100
365
429
  */
366
430
  limit?: number;
367
- /** Pointer to the next or previous page in the list of results. */
431
+ /**
432
+ * Pointer to the next or previous page in the list of results.
433
+ * @maxLength 2000
434
+ */
368
435
  cursor?: string | null;
369
436
  }
370
437
  export interface ListCategoriesResponse {
@@ -380,7 +447,10 @@ export interface MetaData {
380
447
  offset?: number;
381
448
  /** Total number of items that match the query. */
382
449
  total?: number;
383
- /** Pointer to the next or previous page in the list of results. */
450
+ /**
451
+ * Pointer to the next or previous page in the list of results.
452
+ * @maxLength 2000
453
+ */
384
454
  cursor?: string | null;
385
455
  }
386
456
  export interface QueryCategoriesRequest {
@@ -392,6 +462,7 @@ export interface QueryCategoriesRequest {
392
462
  *
393
463
  * To retrieve a field, pass the relevant fieldset in the enum in the `fieldsets` array. For example, add the `URL` fieldset to `fieldsets` to
394
464
  * retrieve the url field in the response in addition to the category’s base fields.
465
+ * @maxSize 10
395
466
  */
396
467
  fieldsets?: Field[];
397
468
  }
@@ -412,6 +483,7 @@ export interface PlatformQuery extends PlatformQueryPagingMethodOneOf {
412
483
  /**
413
484
  * Sort object in the following format:
414
485
  * `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`
486
+ * @maxSize 3
415
487
  */
416
488
  sort?: Sorting[];
417
489
  }
@@ -423,7 +495,10 @@ export interface PlatformQueryPagingMethodOneOf {
423
495
  cursorPaging?: CursorPaging;
424
496
  }
425
497
  export interface Sorting {
426
- /** Name of the field to sort by. */
498
+ /**
499
+ * Name of the field to sort by.
500
+ * @maxLength 512
501
+ */
427
502
  fieldName?: string;
428
503
  /** Sort order. */
429
504
  order?: SortOrder;
@@ -433,13 +508,19 @@ export declare enum SortOrder {
433
508
  DESC = "DESC"
434
509
  }
435
510
  export interface Paging {
436
- /** Number of items to load. */
511
+ /**
512
+ * Number of items to load.
513
+ * @max 100
514
+ */
437
515
  limit?: number | null;
438
516
  /** Number of items to skip in the current sort order. */
439
517
  offset?: number | null;
440
518
  }
441
519
  export interface CursorPaging {
442
- /** Number of items to load. */
520
+ /**
521
+ * Number of items to load.
522
+ * @max 100
523
+ */
443
524
  limit?: number | null;
444
525
  /**
445
526
  * Pointer to the next or previous page in the list of results.
@@ -447,6 +528,7 @@ export interface CursorPaging {
447
528
  * You can get the relevant cursor token
448
529
  * from the `pagingMetadata` object in the previous call's response.
449
530
  * Not relevant for the first request.
531
+ * @maxLength 2000
450
532
  */
451
533
  cursor?: string | null;
452
534
  }
@@ -469,13 +551,24 @@ export interface PagingMetadataV2 {
469
551
  cursors?: Cursors;
470
552
  }
471
553
  export interface Cursors {
472
- /** Cursor pointing to next page in the list of results. */
554
+ /**
555
+ * Cursor pointing to next page in the list of results.
556
+ * @maxLength 2000
557
+ */
473
558
  next?: string | null;
474
- /** Cursor pointing to previous page in the list of results. */
559
+ /**
560
+ * Cursor pointing to previous page in the list of results.
561
+ * @maxLength 2000
562
+ */
475
563
  prev?: string | null;
476
564
  }
477
565
  export interface BulkDeleteCategoryRequest {
478
- /** Category IDs. */
566
+ /**
567
+ * Category IDs.
568
+ * @minSize 1
569
+ * @maxSize 100
570
+ * @maxLength 38
571
+ */
479
572
  categoryIds?: string[];
480
573
  /** Should delete bypassing the trash-bin. */
481
574
  permanent?: boolean;
@@ -483,7 +576,11 @@ export interface BulkDeleteCategoryRequest {
483
576
  export interface BulkDeleteCategoryResponse {
484
577
  }
485
578
  export interface DeleteCategoryRequest {
486
- /** Category ID. */
579
+ /**
580
+ * Category ID.
581
+ * @minLength 1
582
+ * @maxLength 38
583
+ */
487
584
  categoryId: string;
488
585
  }
489
586
  export interface DeleteCategoryResponse {
@@ -561,9 +658,15 @@ export interface ActionEvent {
561
658
  bodyAsJson?: string;
562
659
  }
563
660
  export interface MessageEnvelope {
564
- /** App instance ID. */
661
+ /**
662
+ * App instance ID.
663
+ * @format GUID
664
+ */
565
665
  instanceId?: string | null;
566
- /** Event type. */
666
+ /**
667
+ * Event type.
668
+ * @maxLength 150
669
+ */
567
670
  eventType?: string;
568
671
  /** The identification type and identity data. */
569
672
  identity?: IdentificationData;
@@ -571,26 +674,50 @@ export interface MessageEnvelope {
571
674
  data?: string;
572
675
  }
573
676
  export interface IdentificationData extends IdentificationDataIdOneOf {
574
- /** ID of a site visitor that has not logged in to the site. */
677
+ /**
678
+ * ID of a site visitor that has not logged in to the site.
679
+ * @format GUID
680
+ */
575
681
  anonymousVisitorId?: string;
576
- /** ID of a site visitor that has logged in to the site. */
682
+ /**
683
+ * ID of a site visitor that has logged in to the site.
684
+ * @format GUID
685
+ */
577
686
  memberId?: string;
578
- /** ID of a Wix user (site owner, contributor, etc.). */
687
+ /**
688
+ * ID of a Wix user (site owner, contributor, etc.).
689
+ * @format GUID
690
+ */
579
691
  wixUserId?: string;
580
- /** ID of an app. */
692
+ /**
693
+ * ID of an app.
694
+ * @format GUID
695
+ */
581
696
  appId?: string;
582
697
  /** @readonly */
583
698
  identityType?: WebhookIdentityType;
584
699
  }
585
700
  /** @oneof */
586
701
  export interface IdentificationDataIdOneOf {
587
- /** ID of a site visitor that has not logged in to the site. */
702
+ /**
703
+ * ID of a site visitor that has not logged in to the site.
704
+ * @format GUID
705
+ */
588
706
  anonymousVisitorId?: string;
589
- /** ID of a site visitor that has logged in to the site. */
707
+ /**
708
+ * ID of a site visitor that has logged in to the site.
709
+ * @format GUID
710
+ */
590
711
  memberId?: string;
591
- /** ID of a Wix user (site owner, contributor, etc.). */
712
+ /**
713
+ * ID of a Wix user (site owner, contributor, etc.).
714
+ * @format GUID
715
+ */
592
716
  wixUserId?: string;
593
- /** ID of an app. */
717
+ /**
718
+ * ID of an app.
719
+ * @format GUID
720
+ */
594
721
  appId?: string;
595
722
  }
596
723
  export declare enum WebhookIdentityType {
@@ -1 +1 @@
1
- {"version":3,"file":"blog-v3-category-categories.types.js","sourceRoot":"","sources":["../../../../src/blog-v3-category-categories.types.ts"],"names":[],"mappings":"AAuLA,MAAM,CAAN,IAAY,KAWX;AAXD,WAAY,KAAK;IACf,4BAAmB,CAAA;IACnB,6BAA6B;IAC7B,oBAAW,CAAA;IACX;;;OAGG;IACH,oCAA2B,CAAA;IAC3B,yBAAyB;IACzB,oBAAW,CAAA;AACb,CAAC,EAXW,KAAK,KAAL,KAAK,QAWhB;AAkRD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAoLD,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,kCAAW,CAAA;AACb,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B"}
1
+ {"version":3,"file":"blog-v3-category-categories.types.js","sourceRoot":"","sources":["../../../../src/blog-v3-category-categories.types.ts"],"names":[],"mappings":"AA0NA,MAAM,CAAN,IAAY,KAWX;AAXD,WAAY,KAAK;IACf,4BAAmB,CAAA;IACnB,6BAA6B;IAC7B,oBAAW,CAAA;IACX;;;OAGG;IACH,oCAA2B,CAAA;IAC3B,yBAAyB;IACzB,oBAAW,CAAA;AACb,CAAC,EAXW,KAAK,KAAL,KAAK,QAWhB;AA0TD,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,wBAAW,CAAA;IACX,0BAAa,CAAA;AACf,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAwOD,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,kCAAW,CAAA;AACb,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B"}