@wix/auto_sdk_editor-branches_branches 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.
Files changed (111) hide show
  1. package/build/cjs/index.d.ts +1 -0
  2. package/build/cjs/index.js +18 -0
  3. package/build/cjs/index.js.map +1 -0
  4. package/build/cjs/index.typings.d.ts +1 -0
  5. package/build/cjs/index.typings.js +18 -0
  6. package/build/cjs/index.typings.js.map +1 -0
  7. package/build/cjs/meta.d.ts +1 -0
  8. package/build/cjs/meta.js +18 -0
  9. package/build/cjs/meta.js.map +1 -0
  10. package/build/cjs/src/editor-branches-v1-branch-branches.context.d.ts +19 -0
  11. package/build/cjs/src/editor-branches-v1-branch-branches.context.js +27 -0
  12. package/build/cjs/src/editor-branches-v1-branch-branches.context.js.map +1 -0
  13. package/build/cjs/src/editor-branches-v1-branch-branches.http.d.ts +18 -0
  14. package/build/cjs/src/editor-branches-v1-branch-branches.http.js +210 -0
  15. package/build/cjs/src/editor-branches-v1-branch-branches.http.js.map +1 -0
  16. package/build/cjs/src/editor-branches-v1-branch-branches.meta.d.ts +23 -0
  17. package/build/cjs/src/editor-branches-v1-branch-branches.meta.js +123 -0
  18. package/build/cjs/src/editor-branches-v1-branch-branches.meta.js.map +1 -0
  19. package/build/cjs/src/editor-branches-v1-branch-branches.public.d.ts +54 -0
  20. package/build/cjs/src/editor-branches-v1-branch-branches.public.js +76 -0
  21. package/build/cjs/src/editor-branches-v1-branch-branches.public.js.map +1 -0
  22. package/build/cjs/src/editor-branches-v1-branch-branches.types.d.ts +468 -0
  23. package/build/cjs/src/editor-branches-v1-branch-branches.types.js +46 -0
  24. package/build/cjs/src/editor-branches-v1-branch-branches.types.js.map +1 -0
  25. package/build/cjs/src/editor-branches-v1-branch-branches.universal.d.ts +752 -0
  26. package/build/cjs/src/editor-branches-v1-branch-branches.universal.js +272 -0
  27. package/build/cjs/src/editor-branches-v1-branch-branches.universal.js.map +1 -0
  28. package/build/es/index.d.ts +1 -0
  29. package/build/es/index.js +2 -0
  30. package/build/es/index.js.map +1 -0
  31. package/build/es/index.typings.d.ts +1 -0
  32. package/build/es/index.typings.js +2 -0
  33. package/build/es/index.typings.js.map +1 -0
  34. package/build/es/meta.d.ts +1 -0
  35. package/build/es/meta.js +2 -0
  36. package/build/es/meta.js.map +1 -0
  37. package/build/es/package.json +3 -0
  38. package/build/es/src/editor-branches-v1-branch-branches.context.d.ts +19 -0
  39. package/build/es/src/editor-branches-v1-branch-branches.context.js +19 -0
  40. package/build/es/src/editor-branches-v1-branch-branches.context.js.map +1 -0
  41. package/build/es/src/editor-branches-v1-branch-branches.http.d.ts +18 -0
  42. package/build/es/src/editor-branches-v1-branch-branches.http.js +202 -0
  43. package/build/es/src/editor-branches-v1-branch-branches.http.js.map +1 -0
  44. package/build/es/src/editor-branches-v1-branch-branches.meta.d.ts +23 -0
  45. package/build/es/src/editor-branches-v1-branch-branches.meta.js +92 -0
  46. package/build/es/src/editor-branches-v1-branch-branches.meta.js.map +1 -0
  47. package/build/es/src/editor-branches-v1-branch-branches.public.d.ts +54 -0
  48. package/build/es/src/editor-branches-v1-branch-branches.public.js +63 -0
  49. package/build/es/src/editor-branches-v1-branch-branches.public.js.map +1 -0
  50. package/build/es/src/editor-branches-v1-branch-branches.types.d.ts +468 -0
  51. package/build/es/src/editor-branches-v1-branch-branches.types.js +43 -0
  52. package/build/es/src/editor-branches-v1-branch-branches.types.js.map +1 -0
  53. package/build/es/src/editor-branches-v1-branch-branches.universal.d.ts +752 -0
  54. package/build/es/src/editor-branches-v1-branch-branches.universal.js +241 -0
  55. package/build/es/src/editor-branches-v1-branch-branches.universal.js.map +1 -0
  56. package/build/internal/cjs/index.d.ts +1 -0
  57. package/build/internal/cjs/index.js +18 -0
  58. package/build/internal/cjs/index.js.map +1 -0
  59. package/build/internal/cjs/index.typings.d.ts +1 -0
  60. package/build/internal/cjs/index.typings.js +18 -0
  61. package/build/internal/cjs/index.typings.js.map +1 -0
  62. package/build/internal/cjs/meta.d.ts +1 -0
  63. package/build/internal/cjs/meta.js +18 -0
  64. package/build/internal/cjs/meta.js.map +1 -0
  65. package/build/internal/cjs/src/editor-branches-v1-branch-branches.context.d.ts +19 -0
  66. package/build/internal/cjs/src/editor-branches-v1-branch-branches.context.js +27 -0
  67. package/build/internal/cjs/src/editor-branches-v1-branch-branches.context.js.map +1 -0
  68. package/build/internal/cjs/src/editor-branches-v1-branch-branches.http.d.ts +18 -0
  69. package/build/internal/cjs/src/editor-branches-v1-branch-branches.http.js +210 -0
  70. package/build/internal/cjs/src/editor-branches-v1-branch-branches.http.js.map +1 -0
  71. package/build/internal/cjs/src/editor-branches-v1-branch-branches.meta.d.ts +23 -0
  72. package/build/internal/cjs/src/editor-branches-v1-branch-branches.meta.js +123 -0
  73. package/build/internal/cjs/src/editor-branches-v1-branch-branches.meta.js.map +1 -0
  74. package/build/internal/cjs/src/editor-branches-v1-branch-branches.public.d.ts +54 -0
  75. package/build/internal/cjs/src/editor-branches-v1-branch-branches.public.js +76 -0
  76. package/build/internal/cjs/src/editor-branches-v1-branch-branches.public.js.map +1 -0
  77. package/build/internal/cjs/src/editor-branches-v1-branch-branches.types.d.ts +468 -0
  78. package/build/internal/cjs/src/editor-branches-v1-branch-branches.types.js +46 -0
  79. package/build/internal/cjs/src/editor-branches-v1-branch-branches.types.js.map +1 -0
  80. package/build/internal/cjs/src/editor-branches-v1-branch-branches.universal.d.ts +752 -0
  81. package/build/internal/cjs/src/editor-branches-v1-branch-branches.universal.js +272 -0
  82. package/build/internal/cjs/src/editor-branches-v1-branch-branches.universal.js.map +1 -0
  83. package/build/internal/es/index.d.ts +1 -0
  84. package/build/internal/es/index.js +2 -0
  85. package/build/internal/es/index.js.map +1 -0
  86. package/build/internal/es/index.typings.d.ts +1 -0
  87. package/build/internal/es/index.typings.js +2 -0
  88. package/build/internal/es/index.typings.js.map +1 -0
  89. package/build/internal/es/meta.d.ts +1 -0
  90. package/build/internal/es/meta.js +2 -0
  91. package/build/internal/es/meta.js.map +1 -0
  92. package/build/internal/es/src/editor-branches-v1-branch-branches.context.d.ts +19 -0
  93. package/build/internal/es/src/editor-branches-v1-branch-branches.context.js +19 -0
  94. package/build/internal/es/src/editor-branches-v1-branch-branches.context.js.map +1 -0
  95. package/build/internal/es/src/editor-branches-v1-branch-branches.http.d.ts +18 -0
  96. package/build/internal/es/src/editor-branches-v1-branch-branches.http.js +202 -0
  97. package/build/internal/es/src/editor-branches-v1-branch-branches.http.js.map +1 -0
  98. package/build/internal/es/src/editor-branches-v1-branch-branches.meta.d.ts +23 -0
  99. package/build/internal/es/src/editor-branches-v1-branch-branches.meta.js +92 -0
  100. package/build/internal/es/src/editor-branches-v1-branch-branches.meta.js.map +1 -0
  101. package/build/internal/es/src/editor-branches-v1-branch-branches.public.d.ts +54 -0
  102. package/build/internal/es/src/editor-branches-v1-branch-branches.public.js +63 -0
  103. package/build/internal/es/src/editor-branches-v1-branch-branches.public.js.map +1 -0
  104. package/build/internal/es/src/editor-branches-v1-branch-branches.types.d.ts +468 -0
  105. package/build/internal/es/src/editor-branches-v1-branch-branches.types.js +43 -0
  106. package/build/internal/es/src/editor-branches-v1-branch-branches.types.js.map +1 -0
  107. package/build/internal/es/src/editor-branches-v1-branch-branches.universal.d.ts +752 -0
  108. package/build/internal/es/src/editor-branches-v1-branch-branches.universal.js +241 -0
  109. package/build/internal/es/src/editor-branches-v1-branch-branches.universal.js.map +1 -0
  110. package/meta/package.json +3 -0
  111. package/package.json +52 -0
@@ -0,0 +1,752 @@
1
+ /**
2
+ * A branch is a version of draft site content that can be edited independently. Also known as a test site.
3
+ * Read more about branches in this [article](https://support.wix.com/en/article/about-test-sites).
4
+ */
5
+ export interface Branch extends BranchSourceOneOf {
6
+ /** Source branch properties. */
7
+ sourceBranchProperties?: SourceBranch;
8
+ /** Source template properties. */
9
+ sourceTemplateProperties?: SourceTemplate;
10
+ /**
11
+ * Branch ID.
12
+ * @format GUID
13
+ * @readonly
14
+ */
15
+ _id?: string | null;
16
+ /**
17
+ * Revision number, which increments by 1 each time the branch is updated.
18
+ * To prevent conflicting changes,
19
+ * the current revision must be passed when updating the branch.
20
+ * @readonly
21
+ */
22
+ revision?: string | null;
23
+ /** Branch type. */
24
+ type?: Type;
25
+ /**
26
+ * Branch name.
27
+ * @maxLength 50
28
+ */
29
+ name?: string | null;
30
+ /** Source type. */
31
+ sourceType?: SourceType;
32
+ /**
33
+ * Date and time the branch was last published, if relevant.
34
+ * @readonly
35
+ */
36
+ lastPublishDate?: string | null;
37
+ /** Editor type. */
38
+ editorType?: EditorType;
39
+ /**
40
+ * Date and time the branch was created.
41
+ * @readonly
42
+ */
43
+ _createdDate?: Date | null;
44
+ /**
45
+ * Date and time the branch was last updated.
46
+ * @readonly
47
+ */
48
+ _updatedDate?: Date | null;
49
+ /**
50
+ * Custom field data for the branch.
51
+ * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
52
+ */
53
+ extendedFields?: ExtendedFields;
54
+ }
55
+ /** @oneof */
56
+ export interface BranchSourceOneOf {
57
+ /** Source branch properties. */
58
+ sourceBranchProperties?: SourceBranch;
59
+ /** Source template properties. */
60
+ sourceTemplateProperties?: SourceTemplate;
61
+ }
62
+ export declare enum Type {
63
+ /** Unknown branch type. */
64
+ UNKNOWN_TYPE = "UNKNOWN_TYPE",
65
+ /** A branch created by a Wix user, that can be accessed for editing and publishing via the editor UI. */
66
+ USER = "USER",
67
+ /** A branch created for technical purposes, unrelated to the Wix user. For internal use, can't be accessed via the editor UI. */
68
+ TECHNICAL = "TECHNICAL",
69
+ /** The original branch of the site, created when the site is created. Can be accessed for editing and publishing in the editor. */
70
+ ORIGINAL_BRANCH = "ORIGINAL_BRANCH"
71
+ }
72
+ export declare enum SourceType {
73
+ /** Unknown source type. */
74
+ UNKNOWN_SOURCE_TYPE = "UNKNOWN_SOURCE_TYPE",
75
+ /** This branch's source was a branch. */
76
+ SOURCE_BRANCH = "SOURCE_BRANCH",
77
+ /** This branch's source was a template. For internal use. */
78
+ SOURCE_TEMPLATE = "SOURCE_TEMPLATE"
79
+ }
80
+ export declare enum EditorType {
81
+ /** Unknown editor type */
82
+ UNKNOWN_EDITOR_TYPE = "UNKNOWN_EDITOR_TYPE",
83
+ /** STUDIO */
84
+ STUDIO = "STUDIO",
85
+ /** CLASSIC */
86
+ CLASSIC = "CLASSIC"
87
+ }
88
+ export interface SourceBranch {
89
+ /**
90
+ * Source branch ID.
91
+ * @format GUID
92
+ */
93
+ branchId?: string;
94
+ /** Source branch revision. */
95
+ branchRevision?: string | null;
96
+ }
97
+ export interface SourceTemplate {
98
+ /**
99
+ * Source template ID.
100
+ * @format GUID
101
+ */
102
+ templateId?: string;
103
+ }
104
+ export interface ExtendedFields {
105
+ /**
106
+ * Extended field data. Each key corresponds to the namespace of the app that created the extended fields.
107
+ * The value of each key is structured according to the schema defined when the extended fields were configured.
108
+ *
109
+ * You can only access fields for which you have the appropriate permissions.
110
+ *
111
+ * Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
112
+ */
113
+ namespaces?: Record<string, Record<string, any>>;
114
+ }
115
+ export interface CreateBranchRequest {
116
+ /** Branch to be created. */
117
+ branch: Branch;
118
+ }
119
+ export interface CreateBranchResponse {
120
+ /** Created branch. */
121
+ branch?: Branch;
122
+ }
123
+ export interface GetBranchRequest {
124
+ /**
125
+ * ID of branch to retrieve.
126
+ * @format GUID
127
+ */
128
+ branchId: string;
129
+ }
130
+ export interface GetBranchResponse {
131
+ /** Requested branch. */
132
+ branch?: Branch;
133
+ }
134
+ export interface UpdateBranchRequest {
135
+ /** Branch to be updated. */
136
+ branch: Branch;
137
+ }
138
+ export interface UpdateBranchResponse {
139
+ /** Updated branch. */
140
+ branch?: Branch;
141
+ }
142
+ export interface DeleteBranchRequest {
143
+ /**
144
+ * ID of branch to delete.
145
+ * @format GUID
146
+ */
147
+ branchId: string;
148
+ }
149
+ export interface DeleteBranchResponse {
150
+ }
151
+ export interface QueryBranchesRequest {
152
+ /** WQL expression. */
153
+ query?: CursorQuery;
154
+ }
155
+ export interface CursorQuery extends CursorQueryPagingMethodOneOf {
156
+ /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
157
+ cursorPaging?: CursorPaging;
158
+ /**
159
+ * Filter object in the following format: `"filter" : { "fieldName1": "value1", "fieldName2":{"$operator":"value2"}}`.
160
+ *
161
+ * Filterable fields:
162
+ *
163
+ * `type`
164
+ * `name`
165
+ * `updatedDate`
166
+ * `createdDate`
167
+ * `lastPublishDate`
168
+ * `sourceBranchProperties.branchId`
169
+ * `sourceBranchProperties.branchRevision`
170
+ *
171
+ * All operators are valid.
172
+ */
173
+ filter?: Record<string, any> | null;
174
+ /**
175
+ * Sort object in the following format: `[{"fieldName":"sortField1","order":"ASC"},{"fieldName":"sortField2","order":"DESC"}]`.
176
+ *
177
+ * Sortable fields:
178
+ *
179
+ * `updatedDate`
180
+ * `createdDate`
181
+ * `lastPublishDate`
182
+ * @maxSize 5
183
+ */
184
+ sort?: Sorting[];
185
+ }
186
+ /** @oneof */
187
+ export interface CursorQueryPagingMethodOneOf {
188
+ /** Cursor token pointing to a page of results. Not used in the first request. Following requests use the cursor token and not `filter` or `sort`. */
189
+ cursorPaging?: CursorPaging;
190
+ }
191
+ export interface Sorting {
192
+ /**
193
+ * Name of the field to sort by.
194
+ * @maxLength 512
195
+ */
196
+ fieldName?: string;
197
+ /** Sort order. */
198
+ order?: SortOrder;
199
+ }
200
+ export declare enum SortOrder {
201
+ ASC = "ASC",
202
+ DESC = "DESC"
203
+ }
204
+ export interface CursorPaging {
205
+ /**
206
+ * Maximum number of items to return in the results.
207
+ * @max 100
208
+ */
209
+ limit?: number | null;
210
+ /**
211
+ * Pointer to the next or previous page in the list of results.
212
+ *
213
+ * Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response.
214
+ * Not relevant for the first request.
215
+ * @maxLength 16000
216
+ */
217
+ cursor?: string | null;
218
+ }
219
+ export interface QueryBranchesResponse {
220
+ /** List of branches. */
221
+ branches?: Branch[];
222
+ /** Paging metadata */
223
+ pagingMetadata?: CursorPagingMetadata;
224
+ }
225
+ export interface CursorPagingMetadata {
226
+ /** Number of items returned in the response. */
227
+ count?: number | null;
228
+ /** Cursor strings that point to the next page, previous page, or both. */
229
+ cursors?: Cursors;
230
+ /**
231
+ * Whether there are more pages to retrieve following the current page.
232
+ *
233
+ * + `true`: Another page of results can be retrieved.
234
+ * + `false`: This is the last page.
235
+ */
236
+ hasNext?: boolean | null;
237
+ }
238
+ export interface Cursors {
239
+ /**
240
+ * Cursor string pointing to the next page in the list of results.
241
+ * @maxLength 16000
242
+ */
243
+ next?: string | null;
244
+ /**
245
+ * Cursor pointing to the previous page in the list of results.
246
+ * @maxLength 16000
247
+ */
248
+ prev?: string | null;
249
+ }
250
+ export interface UpdateExtendedFieldsRequest {
251
+ /** ID of the entity to update. */
252
+ _id?: string;
253
+ /** Identifier for the app whose extended fields are being updated. */
254
+ namespace?: string;
255
+ /** Data to update. Structured according to the [schema](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields#json-schema-for-extended-fields) defined when the extended fields were configured. */
256
+ namespaceData?: Record<string, any> | null;
257
+ }
258
+ export interface UpdateExtendedFieldsResponse {
259
+ /** Updated branch. */
260
+ branch?: Branch;
261
+ }
262
+ export interface HtmlSitePublished {
263
+ /**
264
+ * Application instance ID
265
+ * @maxLength 50
266
+ */
267
+ appInstanceId?: string;
268
+ /**
269
+ * Application type
270
+ * @maxLength 100
271
+ */
272
+ appType?: string;
273
+ /** Revision */
274
+ revision?: string;
275
+ /**
276
+ * MSID
277
+ * @maxLength 100
278
+ */
279
+ metaSiteId?: string | null;
280
+ /**
281
+ * optional branch id if publish is done from branch
282
+ * @format GUID
283
+ */
284
+ branchId?: string | null;
285
+ /** The site's last transactionId */
286
+ lastTransactionId?: string | null;
287
+ /** A list of the site's pages */
288
+ pages?: Page[];
289
+ /** Site's publish date */
290
+ publishDate?: string;
291
+ }
292
+ export interface Page {
293
+ /**
294
+ * Page's Id
295
+ * @maxLength 100
296
+ */
297
+ _id?: string;
298
+ }
299
+ export interface Empty {
300
+ }
301
+ export interface DomainEvent extends DomainEventBodyOneOf {
302
+ createdEvent?: EntityCreatedEvent;
303
+ updatedEvent?: EntityUpdatedEvent;
304
+ deletedEvent?: EntityDeletedEvent;
305
+ actionEvent?: ActionEvent;
306
+ /**
307
+ * Unique event ID.
308
+ * Allows clients to ignore duplicate webhooks.
309
+ */
310
+ _id?: string;
311
+ /**
312
+ * Assumes actions are also always typed to an entity_type
313
+ * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
314
+ */
315
+ entityFqdn?: string;
316
+ /**
317
+ * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
318
+ * This is although the created/updated/deleted notion is duplication of the oneof types
319
+ * Example: created/updated/deleted/started/completed/email_opened
320
+ */
321
+ slug?: string;
322
+ /** ID of the entity associated with the event. */
323
+ entityId?: string;
324
+ /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
325
+ eventTime?: Date | null;
326
+ /**
327
+ * Whether the event was triggered as a result of a privacy regulation application
328
+ * (for example, GDPR).
329
+ */
330
+ triggeredByAnonymizeRequest?: boolean | null;
331
+ /** If present, indicates the action that triggered the event. */
332
+ originatedFrom?: string | null;
333
+ /**
334
+ * A sequence number defining the order of updates to the underlying entity.
335
+ * For example, given that some entity was updated at 16:00 and than again at 16:01,
336
+ * it is guaranteed that the sequence number of the second update is strictly higher than the first.
337
+ * As the consumer, you can use this value to ensure that you handle messages in the correct order.
338
+ * To do so, you will need to persist this number on your end, and compare the sequence number from the
339
+ * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
340
+ */
341
+ entityEventSequence?: string | null;
342
+ }
343
+ /** @oneof */
344
+ export interface DomainEventBodyOneOf {
345
+ createdEvent?: EntityCreatedEvent;
346
+ updatedEvent?: EntityUpdatedEvent;
347
+ deletedEvent?: EntityDeletedEvent;
348
+ actionEvent?: ActionEvent;
349
+ }
350
+ export interface EntityCreatedEvent {
351
+ entity?: string;
352
+ }
353
+ export interface RestoreInfo {
354
+ deletedDate?: Date | null;
355
+ }
356
+ export interface EntityUpdatedEvent {
357
+ /**
358
+ * Since platformized APIs only expose PATCH and not PUT we can't assume that the fields sent from the client are the actual diff.
359
+ * This means that to generate a list of changed fields (as opposed to sent fields) one needs to traverse both objects.
360
+ * We don't want to impose this on all developers and so we leave this traversal to the notification recipients which need it.
361
+ */
362
+ currentEntity?: string;
363
+ }
364
+ export interface EntityDeletedEvent {
365
+ /** Entity that was deleted */
366
+ deletedEntity?: string | null;
367
+ }
368
+ export interface ActionEvent {
369
+ body?: string;
370
+ }
371
+ export interface MessageEnvelope {
372
+ /**
373
+ * App instance ID.
374
+ * @format GUID
375
+ */
376
+ instanceId?: string | null;
377
+ /**
378
+ * Event type.
379
+ * @maxLength 150
380
+ */
381
+ eventType?: string;
382
+ /** The identification type and identity data. */
383
+ identity?: IdentificationData;
384
+ /** Stringify payload. */
385
+ data?: string;
386
+ }
387
+ export interface IdentificationData extends IdentificationDataIdOneOf {
388
+ /**
389
+ * ID of a site visitor that has not logged in to the site.
390
+ * @format GUID
391
+ */
392
+ anonymousVisitorId?: string;
393
+ /**
394
+ * ID of a site visitor that has logged in to the site.
395
+ * @format GUID
396
+ */
397
+ memberId?: string;
398
+ /**
399
+ * ID of a Wix user (site owner, contributor, etc.).
400
+ * @format GUID
401
+ */
402
+ wixUserId?: string;
403
+ /**
404
+ * ID of an app.
405
+ * @format GUID
406
+ */
407
+ appId?: string;
408
+ /** @readonly */
409
+ identityType?: WebhookIdentityType;
410
+ }
411
+ /** @oneof */
412
+ export interface IdentificationDataIdOneOf {
413
+ /**
414
+ * ID of a site visitor that has not logged in to the site.
415
+ * @format GUID
416
+ */
417
+ anonymousVisitorId?: string;
418
+ /**
419
+ * ID of a site visitor that has logged in to the site.
420
+ * @format GUID
421
+ */
422
+ memberId?: string;
423
+ /**
424
+ * ID of a Wix user (site owner, contributor, etc.).
425
+ * @format GUID
426
+ */
427
+ wixUserId?: string;
428
+ /**
429
+ * ID of an app.
430
+ * @format GUID
431
+ */
432
+ appId?: string;
433
+ }
434
+ export declare enum WebhookIdentityType {
435
+ UNKNOWN = "UNKNOWN",
436
+ ANONYMOUS_VISITOR = "ANONYMOUS_VISITOR",
437
+ MEMBER = "MEMBER",
438
+ WIX_USER = "WIX_USER",
439
+ APP = "APP"
440
+ }
441
+ interface SourceBranchNonNullableFields {
442
+ branchId: string;
443
+ }
444
+ interface SourceTemplateNonNullableFields {
445
+ templateId: string;
446
+ }
447
+ export interface BranchNonNullableFields {
448
+ sourceBranchProperties?: SourceBranchNonNullableFields;
449
+ sourceTemplateProperties?: SourceTemplateNonNullableFields;
450
+ type: Type;
451
+ sourceType: SourceType;
452
+ editorType: EditorType;
453
+ }
454
+ export interface CreateBranchResponseNonNullableFields {
455
+ branch?: BranchNonNullableFields;
456
+ }
457
+ export interface GetBranchResponseNonNullableFields {
458
+ branch?: BranchNonNullableFields;
459
+ }
460
+ export interface UpdateBranchResponseNonNullableFields {
461
+ branch?: BranchNonNullableFields;
462
+ }
463
+ export interface QueryBranchesResponseNonNullableFields {
464
+ branches: BranchNonNullableFields[];
465
+ }
466
+ export interface BaseEventMetadata {
467
+ /**
468
+ * App instance ID.
469
+ * @format GUID
470
+ */
471
+ instanceId?: string | null;
472
+ /**
473
+ * Event type.
474
+ * @maxLength 150
475
+ */
476
+ eventType?: string;
477
+ /** The identification type and identity data. */
478
+ identity?: IdentificationData;
479
+ }
480
+ export interface EventMetadata extends BaseEventMetadata {
481
+ /**
482
+ * Unique event ID.
483
+ * Allows clients to ignore duplicate webhooks.
484
+ */
485
+ _id?: string;
486
+ /**
487
+ * Assumes actions are also always typed to an entity_type
488
+ * Example: wix.stores.catalog.product, wix.bookings.session, wix.payments.transaction
489
+ */
490
+ entityFqdn?: string;
491
+ /**
492
+ * This is top level to ease client code dispatching of messages (switch on entity_fqdn+slug)
493
+ * This is although the created/updated/deleted notion is duplication of the oneof types
494
+ * Example: created/updated/deleted/started/completed/email_opened
495
+ */
496
+ slug?: string;
497
+ /** ID of the entity associated with the event. */
498
+ entityId?: string;
499
+ /** Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example: 2020-04-26T13:57:50.699Z */
500
+ eventTime?: Date | null;
501
+ /**
502
+ * Whether the event was triggered as a result of a privacy regulation application
503
+ * (for example, GDPR).
504
+ */
505
+ triggeredByAnonymizeRequest?: boolean | null;
506
+ /** If present, indicates the action that triggered the event. */
507
+ originatedFrom?: string | null;
508
+ /**
509
+ * A sequence number defining the order of updates to the underlying entity.
510
+ * For example, given that some entity was updated at 16:00 and than again at 16:01,
511
+ * it is guaranteed that the sequence number of the second update is strictly higher than the first.
512
+ * As the consumer, you can use this value to ensure that you handle messages in the correct order.
513
+ * To do so, you will need to persist this number on your end, and compare the sequence number from the
514
+ * message against the one you have stored. Given that the stored number is higher, you should ignore the message.
515
+ */
516
+ entityEventSequence?: string | null;
517
+ }
518
+ export interface BranchCreatedEnvelope {
519
+ entity: Branch;
520
+ metadata: EventMetadata;
521
+ }
522
+ /** @permissionScope Manage Site Branches
523
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
524
+ * @permissionId EDITOR.BRANCH_READ
525
+ * @webhook
526
+ * @eventType wix.editor.branches.v1.branch_created
527
+ * @slug created
528
+ */
529
+ export declare function onBranchCreated(handler: (event: BranchCreatedEnvelope) => void | Promise<void>): void;
530
+ export interface BranchDeletedEnvelope {
531
+ entity: Branch;
532
+ metadata: EventMetadata;
533
+ }
534
+ /** @permissionScope Manage Site Branches
535
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
536
+ * @permissionId EDITOR.BRANCH_READ
537
+ * @webhook
538
+ * @eventType wix.editor.branches.v1.branch_deleted
539
+ * @slug deleted
540
+ */
541
+ export declare function onBranchDeleted(handler: (event: BranchDeletedEnvelope) => void | Promise<void>): void;
542
+ export interface BranchUpdatedEnvelope {
543
+ entity: Branch;
544
+ metadata: EventMetadata;
545
+ }
546
+ /** @permissionScope Manage Site Branches
547
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
548
+ * @permissionId EDITOR.BRANCH_READ
549
+ * @webhook
550
+ * @eventType wix.editor.branches.v1.branch_updated
551
+ * @slug updated
552
+ */
553
+ export declare function onBranchUpdated(handler: (event: BranchUpdatedEnvelope) => void | Promise<void>): void;
554
+ /**
555
+ * Creates a branch.
556
+ * If a source branch is not provided, the branch will include a blank website.
557
+ * @param branch - Branch to be created.
558
+ * @public
559
+ * @documentationMaturity preview
560
+ * @requiredField branch
561
+ * @permissionId EDITOR.BRANCH_CREATE
562
+ * @permissionScope Manage Site Branches
563
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
564
+ * @applicableIdentity APP
565
+ * @returns Created branch.
566
+ * @fqn wix.editor.branches.v1.BranchesService.CreateBranch
567
+ */
568
+ export declare function createBranch(branch: Branch): Promise<Branch & BranchNonNullableFields>;
569
+ /**
570
+ * Retrieves a branch.
571
+ * @param branchId - ID of branch to retrieve.
572
+ * @public
573
+ * @documentationMaturity preview
574
+ * @requiredField branchId
575
+ * @permissionId EDITOR.BRANCH_READ
576
+ * @permissionScope Manage Site Branches
577
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
578
+ * @applicableIdentity APP
579
+ * @returns Requested branch.
580
+ * @fqn wix.editor.branches.v1.BranchesService.GetBranch
581
+ */
582
+ export declare function getBranch(branchId: string): Promise<Branch & BranchNonNullableFields>;
583
+ /**
584
+ * Updates a branch.
585
+ *
586
+ * `ORIGINAL_BRANCH` types can't be updated.
587
+ * @param _id - Branch ID.
588
+ * @public
589
+ * @documentationMaturity preview
590
+ * @requiredField _id
591
+ * @requiredField branch
592
+ * @requiredField branch.revision
593
+ * @permissionId EDITOR.BRANCH_UPDATE
594
+ * @permissionScope Manage Site Branches
595
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
596
+ * @applicableIdentity APP
597
+ * @returns Updated branch.
598
+ * @fqn wix.editor.branches.v1.BranchesService.UpdateBranch
599
+ */
600
+ export declare function updateBranch(_id: string | null, branch: UpdateBranch): Promise<Branch & BranchNonNullableFields>;
601
+ export interface UpdateBranch {
602
+ /** Source branch properties. */
603
+ sourceBranchProperties?: SourceBranch;
604
+ /** Source template properties. */
605
+ sourceTemplateProperties?: SourceTemplate;
606
+ /**
607
+ * Branch ID.
608
+ * @format GUID
609
+ * @readonly
610
+ */
611
+ _id?: string | null;
612
+ /**
613
+ * Revision number, which increments by 1 each time the branch is updated.
614
+ * To prevent conflicting changes,
615
+ * the current revision must be passed when updating the branch.
616
+ * @readonly
617
+ */
618
+ revision?: string | null;
619
+ /** Branch type. */
620
+ type?: Type;
621
+ /**
622
+ * Branch name.
623
+ * @maxLength 50
624
+ */
625
+ name?: string | null;
626
+ /** Source type. */
627
+ sourceType?: SourceType;
628
+ /**
629
+ * Date and time the branch was last published, if relevant.
630
+ * @readonly
631
+ */
632
+ lastPublishDate?: string | null;
633
+ /** Editor type. */
634
+ editorType?: EditorType;
635
+ /**
636
+ * Date and time the branch was created.
637
+ * @readonly
638
+ */
639
+ _createdDate?: Date | null;
640
+ /**
641
+ * Date and time the branch was last updated.
642
+ * @readonly
643
+ */
644
+ _updatedDate?: Date | null;
645
+ /**
646
+ * Custom field data for the branch.
647
+ * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
648
+ */
649
+ extendedFields?: ExtendedFields;
650
+ }
651
+ /**
652
+ * Permanently deletes a branch.
653
+ * @param branchId - ID of branch to delete.
654
+ * @public
655
+ * @documentationMaturity preview
656
+ * @requiredField branchId
657
+ * @permissionId EDITOR.BRANCH_DELETE
658
+ * @permissionScope Manage Site Branches
659
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
660
+ * @applicableIdentity APP
661
+ * @fqn wix.editor.branches.v1.BranchesService.DeleteBranch
662
+ */
663
+ export declare function deleteBranch(branchId: string): Promise<void>;
664
+ /**
665
+ * Retrieves a list of branches, given the specified [paging, filtering, and sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language).
666
+ * @public
667
+ * @documentationMaturity preview
668
+ * @permissionScope Manage Site Branches
669
+ * @permissionScopeId SCOPE.DC-DOCUMENT-MANAGEMENT.MANAGE-BRANCHES
670
+ * @permissionId EDITOR.BRANCH_READ
671
+ * @applicableIdentity APP
672
+ * @fqn wix.editor.branches.v1.BranchesService.QueryBranches
673
+ */
674
+ export declare function queryBranches(): BranchesQueryBuilder;
675
+ interface QueryCursorResult {
676
+ cursors: Cursors;
677
+ hasNext: () => boolean;
678
+ hasPrev: () => boolean;
679
+ length: number;
680
+ pageSize: number;
681
+ }
682
+ export interface BranchesQueryResult extends QueryCursorResult {
683
+ items: Branch[];
684
+ query: BranchesQueryBuilder;
685
+ next: () => Promise<BranchesQueryResult>;
686
+ prev: () => Promise<BranchesQueryResult>;
687
+ }
688
+ export interface BranchesQueryBuilder {
689
+ /** @param propertyName - Property whose value is compared with `value`.
690
+ * @param value - Value to compare against.
691
+ * @documentationMaturity preview
692
+ */
693
+ eq: (propertyName: 'sourceBranchProperties.branchId' | 'sourceBranchProperties.branchRevision' | 'type' | 'name' | 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any) => BranchesQueryBuilder;
694
+ /** @param propertyName - Property whose value is compared with `value`.
695
+ * @param value - Value to compare against.
696
+ * @documentationMaturity preview
697
+ */
698
+ ne: (propertyName: 'type' | 'name' | 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any) => BranchesQueryBuilder;
699
+ /** @param propertyName - Property whose value is compared with `value`.
700
+ * @param value - Value to compare against.
701
+ * @documentationMaturity preview
702
+ */
703
+ ge: (propertyName: 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any) => BranchesQueryBuilder;
704
+ /** @param propertyName - Property whose value is compared with `value`.
705
+ * @param value - Value to compare against.
706
+ * @documentationMaturity preview
707
+ */
708
+ gt: (propertyName: 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any) => BranchesQueryBuilder;
709
+ /** @param propertyName - Property whose value is compared with `value`.
710
+ * @param value - Value to compare against.
711
+ * @documentationMaturity preview
712
+ */
713
+ le: (propertyName: 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any) => BranchesQueryBuilder;
714
+ /** @param propertyName - Property whose value is compared with `value`.
715
+ * @param value - Value to compare against.
716
+ * @documentationMaturity preview
717
+ */
718
+ lt: (propertyName: 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any) => BranchesQueryBuilder;
719
+ /** @param propertyName - Property whose value is compared with `string`.
720
+ * @param string - String to compare against. Case-insensitive.
721
+ * @documentationMaturity preview
722
+ */
723
+ startsWith: (propertyName: 'name', value: string) => BranchesQueryBuilder;
724
+ /** @param propertyName - Property whose value is compared with `values`.
725
+ * @param values - List of values to compare against.
726
+ * @documentationMaturity preview
727
+ */
728
+ hasSome: (propertyName: 'type' | 'name' | 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any[]) => BranchesQueryBuilder;
729
+ /** @documentationMaturity preview */
730
+ in: (propertyName: 'type' | 'name' | 'lastPublishDate' | '_createdDate' | '_updatedDate', value: any) => BranchesQueryBuilder;
731
+ /** @documentationMaturity preview */
732
+ exists: (propertyName: 'type' | 'name' | 'lastPublishDate' | '_createdDate' | '_updatedDate', value: boolean) => BranchesQueryBuilder;
733
+ /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
734
+ * @documentationMaturity preview
735
+ */
736
+ ascending: (...propertyNames: Array<'type' | 'name' | 'lastPublishDate' | '_createdDate' | '_updatedDate'>) => BranchesQueryBuilder;
737
+ /** @param propertyNames - Properties used in the sort. To sort by multiple properties, pass properties as additional arguments.
738
+ * @documentationMaturity preview
739
+ */
740
+ descending: (...propertyNames: Array<'type' | 'name' | 'lastPublishDate' | '_createdDate' | '_updatedDate'>) => BranchesQueryBuilder;
741
+ /** @param limit - Number of items to return, which is also the `pageSize` of the results object.
742
+ * @documentationMaturity preview
743
+ */
744
+ limit: (limit: number) => BranchesQueryBuilder;
745
+ /** @param cursor - A pointer to specific record
746
+ * @documentationMaturity preview
747
+ */
748
+ skipTo: (cursor: string) => BranchesQueryBuilder;
749
+ /** @documentationMaturity preview */
750
+ find: () => Promise<BranchesQueryResult>;
751
+ }
752
+ export {};