space.highport.defs
Schema Diff
+4 -2
Compatibility Analysis
Breaking Changes Detected
1 breaking change, 0 non-breaking changes.
Breaking Changes (1)
- ConstraintTightened ConstraintTightened { vertex_id: "space.highport.defs#edgeReachStatus", sort: "knownValues", old_value: "[\"unknown\",\"routed\",\"foreign\",\"unreachable\"]", new_value: "[\"unknown\",\"routed\",\"foreign\",\"unreachable\",\"other-deployment\",\"unproven\"]" }
Migration Guidance
Constraint Changes
- ConstraintTightened ConstraintTightened { vertex_id: "space.highport.defs#edgeReachStatus", sort: "knownValues", old_value: "[\"unknown\",\"routed\",\"foreign\",\"unreachable\"]", new_value: "[\"unknown\",\"routed\",\"foreign\",\"unreachable\",\"other-deployment\",\"unproven\"]" }
1
1
{
2
2
"$type": "com.atproto.lexicon.schema",
3
3
"defs": {
4
4
"blobFailure": {
5
5
"properties": {
6
6
"cid": {
7
7
"format": "cid",
8
8
"type": "string"
9
9
},
10
10
"error": {
11
11
"description": "BlobUnavailable, CidMismatch, FetchFailed.",
12
12
"type": "string"
13
13
},
14
14
"role": {
15
15
"knownValues": [
16
16
"manifest",
17
17
"tile",
18
18
"parameter",
19
19
"notFound"
20
20
],
21
21
"type": "string"
22
22
},
23
23
"sourceDid": {
24
24
"format": "did",
25
25
"type": "string"
26
26
}
27
27
},
28
28
"required": [
29
29
"cid",
30
30
"role",
31
31
"sourceDid",
32
32
"error"
33
33
],
34
34
"type": "object"
35
35
},
36
36
"denylistEntry": {
37
37
"properties": {
38
38
"actor": {
39
39
"type": "string"
40
40
},
41
41
"createdAt": {
42
42
"format": "datetime",
43
43
"type": "string"
44
44
},
45
45
"kind": {
46
46
"knownValues": [
47
47
"domain",
48
48
"did",
49
49
"uri",
50
50
"cid",
51
51
"pattern",
52
52
"space"
53
53
],
54
54
"type": "string"
55
55
},
56
56
"reason": {
57
57
"type": "string"
58
58
},
59
59
"subject": {
60
60
"type": "string"
61
61
}
62
62
},
63
63
"required": [
64
64
"subject",
65
65
"kind",
66
66
"createdAt"
67
67
],
68
68
"type": "object"
69
69
},
70
70
"dnsInstruction": {
71
71
"properties": {
72
72
"name": {
73
73
"description": "Fully-qualified record name.",
74
74
"type": "string"
75
75
},
76
76
"purpose": {
77
77
"knownValues": [
78
78
"ownership",
79
79
"certificate",
80
80
"traffic"
81
81
],
82
82
"type": "string"
83
83
},
84
84
"required": {
85
85
"type": "boolean"
86
86
},
87
87
"ttl": {
88
88
"type": "integer"
89
89
},
90
90
"type": {
91
91
"knownValues": [
92
92
"TXT",
93
93
"CNAME",
94
94
"ALIAS",
95
95
"ANAME",
96
96
"A",
97
97
"AAAA"
98
98
],
99
99
"type": "string"
100
100
},
101
101
"value": {
102
102
"type": "string"
103
103
}
104
104
},
105
105
"required": [
106
106
"type",
107
107
"name",
108
108
"value"
109
109
],
110
110
"type": "object"
111
111
},
112
112
"domainEvent": {
113
113
"properties": {
114
114
"actor": {
115
115
"type": "string"
116
116
},
117
117
"createdAt": {
118
118
"format": "datetime",
119
119
"type": "string"
120
120
},
121
121
"detail": {
122
122
"type": "unknown"
123
123
},
124
124
"event": {
125
125
"type": "string"
126
126
}
127
127
},
128
128
"required": [
129
129
"event",
130
130
"createdAt"
131
131
],
132
132
"type": "object"
133
133
},
134
134
"domainStatus": {
135
135
"knownValues": [
136
136
"pending",
137
137
"verifying",
138
138
"verified",
139
139
"active",
140
140
"failed",
141
141
"suspended",
142
142
"released"
143
143
],
144
144
"type": "string"
145
145
},
146
146
"domainView": {
147
147
"properties": {
148
148
"activatedAt": {
149
149
"format": "datetime",
150
150
"type": "string"
151
151
},
152
152
"activeCid": {
153
153
"format": "cid",
154
154
"type": "string"
155
155
},
156
156
"activeRev": {
157
157
"type": "string"
158
158
},
159
159
"activeUri": {
160
160
"format": "at-uri",
161
161
"type": "string"
162
162
},
163
163
"createdAt": {
164
164
"format": "datetime",
165
165
"type": "string"
166
166
},
167
167
"did": {
168
168
"format": "did",
169
169
"type": "string"
170
170
},
171
171
"domain": {
172
172
"type": "string"
173
173
},
174
174
"entryCount": {
175
175
"type": "integer"
176
176
},
177
177
"pendingCid": {
178
178
"description": "A validated, prepared record awaiting its commit, if any.",
179
179
"format": "cid",
180
180
"type": "string"
181
181
},
182
182
"pendingState": {
183
183
"knownValues": [
184
184
"preparing",
185
185
"pending-publication"
186
186
],
187
187
"type": "string"
188
188
},
189
189
"sourceKind": {
190
190
"knownValues": [
191
191
"inline",
192
192
"tile"
193
193
],
194
194
"type": "string"
195
195
},
196
196
"space": {
197
197
"description": "The space the domain is registered to; absent for a DID-registered domain. The serving record is the space authority's.",
198
198
"format": "at-uri",
199
199
"type": "string"
200
200
},
201
201
"status": {
202
202
"ref": "#domainStatus",
203
203
"type": "ref"
204
204
},
205
205
"tileCid": {
206
206
"format": "cid",
207
207
"type": "string"
208
208
},
209
209
"tileUri": {
210
210
"format": "at-uri",
211
211
"type": "string"
212
212
},
213
213
"tls": {
214
214
"ref": "#tlsStatus",
215
215
"type": "ref"
216
216
},
217
217
"totalBytes": {
218
218
"type": "integer"
219
219
},
220
220
"verifiedAt": {
221
221
"format": "datetime",
222
222
"type": "string"
223
223
}
224
224
},
225
225
"required": [
226
226
"domain",
227
227
"did",
228
228
"status",
229
229
"createdAt"
230
230
],
231
231
"type": "object"
232
232
},
233
233
"edgeReachStatus": {
234
-
"description": "Whether bard's edge routes a serving hostname to bard. unknown means no probe has been made and must never be read as a fault; routed means the probe reached bard-origin; foreign means something else answered for the hostname; unreachable means nothing answered at all.",
234
+
"description": "Whether bard's edge routes a serving hostname to this deployment. unknown means no probe has been made and must never be read as a fault; routed means the probe reached this deployment's bard-origin; foreign means something else answered for the hostname; unreachable means nothing answered at all; other-deployment means a bard origin belonging to a different deployment answered; unproven means the answer looked like this deployment's but could not answer the reachability challenge, so something may be imitating it.",
235
235
"knownValues": [
236
236
"unknown",
237
237
"routed",
238
238
"foreign",
239
-
"unreachable"
239
+
"unreachable",
240
+
"other-deployment",
241
+
"unproven"
240
242
],
241
243
"type": "string"
242
244
},
243
245
"edgeReachability": {
244
246
"description": "What the deployment's own edge answered for a hostname, measured over the network rather than read from edge configuration. A site can be indexed and activated while the edge has nowhere to send its hostname, and this is the only field that says so.",
245
247
"properties": {
246
248
"checkedAt": {
247
249
"description": "When the probe was made. Absent when status is unknown.",
248
250
"format": "datetime",
249
251
"type": "string"
250
252
},
251
253
"detail": {
252
254
"description": "What answered, for a person: a status line, or a transport error. Diagnostic only; nothing branches on it.",
253
255
"type": "string"
254
256
},
255
257
"domain": {
256
258
"description": "The hostname that was probed, so a reader is told which name is not arriving.",
257
259
"maxLength": 253,
258
260
"type": "string"
259
261
},
260
262
"status": {
261
263
"ref": "#edgeReachStatus",
262
264
"type": "ref"
263
265
}
264
266
},
265
267
"required": [
266
268
"status",
267
269
"domain"
268
270
],
269
271
"type": "object"
270
272
},
271
273
"indexState": {
272
274
"knownValues": [
273
275
"preparing",
274
276
"pending-publication",
275
277
"expired",
276
278
"queued",
277
279
"fetching",
278
280
"materializing",
279
281
"active",
280
282
"superseded",
281
283
"rejected",
282
284
"failed"
283
285
],
284
286
"type": "string"
285
287
},
286
288
"jobView": {
287
289
"properties": {
288
290
"action": {
289
291
"type": "string"
290
292
},
291
293
"attempts": {
292
294
"type": "integer"
293
295
},
294
296
"finishedAt": {
295
297
"format": "datetime",
296
298
"type": "string"
297
299
},
298
300
"id": {
299
301
"type": "integer"
300
302
},
301
303
"lastError": {
302
304
"type": "string"
303
305
},
304
306
"scheduledAt": {
305
307
"format": "datetime",
306
308
"type": "string"
307
309
},
308
310
"startedAt": {
309
311
"format": "datetime",
310
312
"type": "string"
311
313
},
312
314
"state": {
313
315
"type": "string"
314
316
},
315
317
"uri": {
316
318
"type": "string"
317
319
}
318
320
},
319
321
"required": [
320
322
"id",
321
323
"uri",
322
324
"action",
323
325
"state",
324
326
"attempts",
325
327
"scheduledAt"
326
328
],
327
329
"type": "object"
328
330
},
329
331
"malwareFinding": {
330
332
"description": "One malware detection. Written before anything is denied or deleted, because the quarantine destroys the sample and nothing after that can re-derive why.",
331
333
"properties": {
332
334
"cid": {
333
335
"description": "The content address. `-` for a detection at upload, where nothing was stored.",
334
336
"type": "string"
335
337
},
336
338
"class": {
337
339
"description": "`unwanted` is a PUA match and stops short of the publishing identity under the default policy.",
338
340
"knownValues": [
339
341
"malware",
340
342
"unwanted"
341
343
],
342
344
"type": "string"
343
345
},
344
346
"did": {
345
347
"description": "The repository the bytes were fetched from — for a tile resource the tile's author, not the site owner. Absent for content bard authored.",
346
348
"format": "did",
347
349
"type": "string"
348
350
},
349
351
"domain": {
350
352
"description": "The hostname it would have served at.",
351
353
"type": "string"
352
354
},
353
355
"foundAt": {
354
356
"format": "datetime",
355
357
"type": "string"
356
358
},
357
359
"id": {
358
360
"description": "The finding's row id, which the denylist entry's reason names.",
359
361
"type": "integer"
360
362
},
361
363
"path": {
362
364
"description": "The manifest key the bytes were mapped at — the field that answers which file. Absent where there is no key: the notFound resource, an upload refused before any record referenced it, and a rescan, which starts from a CID.",
363
365
"type": "string"
364
366
},
365
367
"quarantinedAt": {
366
368
"description": "When the response finished. Absent means it has not: the content is denied and may still be served.",
367
369
"format": "datetime",
368
370
"type": "string"
369
371
},
370
372
"signature": {
371
373
"description": "The signature name, verbatim from the engine.",
372
374
"type": "string"
373
375
},
374
376
"source": {
375
377
"description": "Where it was found. `rescan` means the content was clean when it arrived and a signature has caught up with it; `admin` means an operator asked about this CID rather than the sweep reaching it.",
376
378
"knownValues": [
377
379
"fetch",
378
380
"upload",
379
381
"rescan",
380
382
"admin"
381
383
],
382
384
"type": "string"
383
385
},
384
386
"uri": {
385
387
"description": "The record that referenced it.",
386
388
"format": "at-uri",
387
389
"type": "string"
388
390
}
389
391
},
390
392
"required": [
391
393
"id",
392
394
"cid",
393
395
"signature",
394
396
"class",
395
397
"source",
396
398
"foundAt"
397
399
],
398
400
"type": "object"
399
401
},
400
402
"missingBlob": {
401
403
"properties": {
402
404
"cid": {
403
405
"format": "cid",
404
406
"type": "string"
405
407
},
406
408
"role": {
407
409
"knownValues": [
408
410
"manifest",
409
411
"tile",
410
412
"parameter",
411
413
"notFound"
412
414
],
413
415
"type": "string"
414
416
},
415
417
"sourceDid": {
416
418
"format": "did",
417
419
"type": "string"
418
420
}
419
421
},
420
422
"required": [
421
423
"cid",
422
424
"role",
423
425
"sourceDid"
424
426
],
425
427
"type": "object"
426
428
},
427
429
"preparationStatus": {
428
430
"properties": {
429
431
"cid": {
430
432
"format": "cid",
431
433
"type": "string"
432
434
},
433
435
"expiresAt": {
434
436
"format": "datetime",
435
437
"type": "string"
436
438
},
437
439
"failed": {
438
440
"items": {
439
441
"ref": "#blobFailure",
440
442
"type": "ref"
441
443
},
442
444
"type": "array"
443
445
},
444
446
"fetched": {
445
447
"type": "integer"
446
448
},
447
449
"pending": {
448
450
"type": "integer"
449
451
},
450
452
"state": {
451
453
"knownValues": [
452
454
"preparing",
453
455
"pending-publication",
454
456
"expired"
455
457
],
456
458
"type": "string"
457
459
}
458
460
},
459
461
"required": [
460
462
"state",
461
463
"cid",
462
464
"fetched",
463
465
"pending",
464
466
"failed"
465
467
],
466
468
"type": "object"
467
469
},
468
470
"siteView": {
469
471
"properties": {
470
472
"activatedAt": {
471
473
"format": "datetime",
472
474
"type": "string"
473
475
},
474
476
"cid": {
475
477
"format": "cid",
476
478
"type": "string"
477
479
},
478
480
"did": {
479
481
"format": "did",
480
482
"type": "string"
481
483
},
482
484
"domain": {
483
485
"type": "string"
484
486
},
485
487
"rev": {
486
488
"type": "string"
487
489
},
488
490
"sourceKind": {
489
491
"knownValues": [
490
492
"inline",
491
493
"tile"
492
494
],
493
495
"type": "string"
494
496
},
495
497
"space": {
496
498
"description": "Present for a site published from a space; attribution survives the plane.",
497
499
"format": "at-uri",
498
500
"type": "string"
499
501
},
500
502
"tile": {
501
503
"ref": "#tileView",
502
504
"type": "ref"
503
505
},
504
506
"uri": {
505
507
"format": "at-uri",
506
508
"type": "string"
507
509
}
508
510
},
509
511
"required": [
510
512
"domain",
511
513
"did",
512
514
"uri",
513
515
"cid",
514
516
"rev",
515
517
"activatedAt",
516
518
"sourceKind"
517
519
],
518
520
"type": "object"
519
521
},
520
522
"spaceEvent": {
521
523
"properties": {
522
524
"actor": {
523
525
"format": "did",
524
526
"type": "string"
525
527
},
526
528
"at": {
527
529
"format": "datetime",
528
530
"type": "string"
529
531
},
530
532
"cid": {
531
533
"format": "cid",
532
534
"type": "string"
533
535
},
534
536
"kind": {
535
537
"knownValues": [
536
538
"record.created",
537
539
"record.updated",
538
540
"record.deleted",
539
541
"site.activated",
540
542
"site.deactivated",
541
543
"tile.ready",
542
544
"tile.incomplete",
543
545
"tile.deleted",
544
546
"access.granted",
545
547
"access.expired",
546
548
"registration.renewed",
547
549
"registration.lapsed",
548
550
"app-not-allowed",
549
551
"space.deleted"
550
552
],
551
553
"type": "string"
552
554
},
553
555
"seq": {
554
556
"type": "integer"
555
557
},
556
558
"space": {
557
559
"format": "at-uri",
558
560
"type": "string"
559
561
},
560
562
"subject": {
561
563
"type": "string"
562
564
}
563
565
},
564
566
"required": [
565
567
"seq",
566
568
"space",
567
569
"kind",
568
570
"at"
569
571
],
570
572
"type": "object"
571
573
},
572
574
"spaceSyncState": {
573
575
"knownValues": [
574
576
"connecting",
575
577
"syncing",
576
578
"synced",
577
579
"credential-expired",
578
580
"registration-lapsed",
579
581
"app-not-allowed",
580
582
"authority-unreachable",
581
583
"deleted",
582
584
"disconnected"
583
585
],
584
586
"type": "string"
585
587
},
586
588
"spaceView": {
587
589
"properties": {
588
590
"accessExpiresAt": {
589
591
"description": "When bard's current space credential expires; absent when bard holds none.",
590
592
"format": "datetime",
591
593
"type": "string"
592
594
},
593
595
"accessGrantedBy": {
594
596
"format": "did",
595
597
"type": "string"
596
598
},
597
599
"appAccess": {
598
600
"knownValues": [
599
601
"open",
600
602
"allow-list",
601
603
"unknown"
602
604
],
603
605
"type": "string"
604
606
},
605
607
"authority": {
606
608
"format": "did",
607
609
"type": "string"
608
610
},
609
611
"connectedAt": {
610
612
"format": "datetime",
611
613
"type": "string"
612
614
},
613
615
"domainCount": {
614
616
"type": "integer"
615
617
},
616
618
"headRev": {
617
619
"type": "string"
618
620
},
619
621
"lastCheckedAt": {
620
622
"format": "datetime",
621
623
"type": "string"
622
624
},
623
625
"lastNotifiedAt": {
624
626
"format": "datetime",
625
627
"type": "string"
626
628
},
627
629
"policy": {
628
630
"knownValues": [
629
631
"public",
630
632
"member-list",
631
633
"managing-app",
632
634
"unknown"
633
635
],
634
636
"type": "string"
635
637
},
636
638
"queuedNotifications": {
637
639
"description": "Receipts waiting for a credential.",
638
640
"type": "integer"
639
641
},
640
642
"registrationExpiresAt": {
641
643
"format": "datetime",
642
644
"type": "string"
643
645
},
644
646
"skey": {
645
647
"type": "string"
646
648
},
647
649
"syncState": {
648
650
"ref": "#spaceSyncState",
649
651
"type": "ref"
650
652
},
651
653
"tileCount": {
652
654
"type": "integer"
653
655
},
654
656
"uri": {
655
657
"format": "at-uri",
656
658
"type": "string"
657
659
}
658
660
},
659
661
"required": [
660
662
"uri",
661
663
"authority",
662
664
"skey",
663
665
"syncState",
664
666
"connectedAt"
665
667
],
666
668
"type": "object"
667
669
},
668
670
"tileView": {
669
671
"properties": {
670
672
"cid": {
671
673
"format": "cid",
672
674
"type": "string"
673
675
},
674
676
"description": {
675
677
"type": "string"
676
678
},
677
679
"did": {
678
680
"format": "did",
679
681
"type": "string"
680
682
},
681
683
"entryCount": {
682
684
"type": "integer"
683
685
},
684
686
"handle": {
685
687
"description": "The author's handle, present only when it resolves back to did. Absent is normal and not an error: a handle that has just changed, or one whose DNS is unreachable, is reported as absent rather than as a claim, and clients show did instead.",
686
688
"format": "handle",
687
689
"type": "string"
688
690
},
689
691
"iconUrl": {
690
692
"description": "https://highport.space/xrpc/space.highport.sites.getTileIcon?cid={cid}; absent if the tile has no icon.",
691
693
"format": "uri",
692
694
"type": "string"
693
695
},
694
696
"indexedAt": {
695
697
"format": "datetime",
696
698
"type": "string"
697
699
},
698
700
"latestCid": {
699
701
"description": "The newest indexed version at this URI, when it differs from cid.",
700
702
"format": "cid",
701
703
"type": "string"
702
704
},
703
705
"name": {
704
706
"type": "string"
705
707
},
706
708
"params": {
707
709
"items": {
708
710
"ref": "space.highport.sites.tile#param",
709
711
"type": "ref"
710
712
},
711
713
"type": "array"
712
714
},
713
715
"space": {
714
716
"description": "Present for a space tile; never on the public surface.",
715
717
"format": "at-uri",
716
718
"type": "string"
717
719
},
718
720
"state": {
719
721
"knownValues": [
720
722
"indexing",
721
723
"ready",
722
724
"incomplete",
723
725
"rejected",
724
726
"suspended",
725
727
"deleted"
726
728
],
727
729
"type": "string"
728
730
},
729
731
"totalBytes": {
730
732
"type": "integer"
731
733
},
732
734
"uri": {
733
735
"format": "at-uri",
734
736
"type": "string"
735
737
}
736
738
},
737
739
"required": [
738
740
"uri",
739
741
"cid",
740
742
"did",
741
743
"name",
742
744
"state",
743
745
"indexedAt"
744
746
],
745
747
"type": "object"
746
748
},
747
749
"tlsStatus": {
748
750
"knownValues": [
749
751
"none",
750
752
"pending",
751
753
"issued",
752
754
"renewing",
753
755
"failed"
754
756
],
755
757
"type": "string"
756
758
},
757
759
"tlsView": {
758
760
"properties": {
759
761
"expiresAt": {
760
762
"format": "datetime",
761
763
"type": "string"
762
764
},
763
765
"issuedAt": {
764
766
"format": "datetime",
765
767
"type": "string"
766
768
},
767
769
"lastError": {
768
770
"type": "string"
769
771
},
770
772
"status": {
771
773
"ref": "#tlsStatus",
772
774
"type": "ref"
773
775
}
774
776
},
775
777
"required": [
776
778
"status"
777
779
],
778
780
"type": "object"
779
781
},
780
782
"validationError": {
781
783
"properties": {
782
784
"message": {
783
785
"type": "string"
784
786
},
785
787
"name": {
786
788
"description": "A DESIGN.md §3.8 error name, e.g. DuplicatePath, RedirectTargetNotFound, ParameterTypeMismatch.",
787
789
"type": "string"
788
790
},
789
791
"path": {
790
792
"description": "JSON Pointer into the record, when the error concerns one field or entry.",
791
793
"type": "string"
792
794
}
793
795
},
794
796
"required": [
795
797
"name",
796
798
"message"
797
799
],
798
800
"type": "object"
799
801
},
800
802
"verificationCheck": {
801
803
"properties": {
802
804
"checkedAt": {
803
805
"format": "datetime",
804
806
"type": "string"
805
807
},
806
808
"detail": {
807
809
"type": "string"
808
810
},
809
811
"name": {
810
812
"knownValues": [
811
813
"ownership",
812
814
"traffic",
813
815
"conflict"
814
816
],
815
817
"type": "string"
816
818
},
817
819
"passed": {
818
820
"type": "boolean"
819
821
}
820
822
},
821
823
"required": [
822
824
"name",
823
825
"passed",
824
826
"checkedAt"
825
827
],
826
828
"type": "object"
827
829
},
828
830
"verificationView": {
829
831
"properties": {
830
832
"checks": {
831
833
"items": {
832
834
"ref": "#verificationCheck",
833
835
"type": "ref"
834
836
},
835
837
"type": "array"
836
838
},
837
839
"lastCheckedAt": {
838
840
"format": "datetime",
839
841
"type": "string"
840
842
},
841
843
"status": {
842
844
"ref": "#domainStatus",
843
845
"type": "ref"
844
846
}
845
847
},
846
848
"required": [
847
849
"status",
848
850
"checks"
849
851
],
850
852
"type": "object"
851
853
}
852
854
},
853
855
"id": "space.highport.defs",
854
856
"lexicon": 1
855
857
}