@reclaimprotocol/client 0.1.0-dev.2 → 0.1.1
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.
- package/README.md +37 -35
- package/lib/enckeys.d.ts +38 -31
- package/lib/enckeys.js +88 -13
- package/lib/encoding.d.ts +5 -0
- package/lib/encoding.js +19 -3
- package/lib/index.d.ts +3 -3
- package/lib/index.js +2 -2
- package/lib/keypair.d.ts +3 -2
- package/lib/keypair.js +15 -1
- package/lib/reclaim.d.ts +35 -32
- package/lib/reclaim.js +19 -15
- package/lib/result.d.ts +20 -16
- package/lib/result.js +68 -54
- package/lib/routes.gen.d.ts +48 -12
- package/lib/routes.gen.js +13 -4
- package/lib/secp.d.ts +1 -2
- package/lib/secp.js +1 -1
- package/lib/types/openapi.d.ts +2 -2
- package/lib/types/openapi.gen.d.ts +711 -122
- package/package.json +7 -2
- package/src/enckeys.ts +114 -35
- package/src/encoding.ts +21 -3
- package/src/index.ts +6 -3
- package/src/keypair.ts +20 -3
- package/src/reclaim.ts +54 -51
- package/src/result.ts +86 -65
- package/src/routes.gen.ts +13 -4
- package/src/secp.ts +1 -1
- package/src/types/openapi.gen.ts +711 -122
- package/src/types/openapi.ts +2 -2
|
@@ -30,7 +30,10 @@ export interface paths {
|
|
|
30
30
|
path?: never;
|
|
31
31
|
cookie?: never;
|
|
32
32
|
};
|
|
33
|
-
/**
|
|
33
|
+
/**
|
|
34
|
+
* Discover home — search a website to verify
|
|
35
|
+
* @description Default home page. A website-first search: the visitor types a website and picks one to continue to `/site/{domain}`, where they choose what data to prove. Renders popular websites below the search.
|
|
36
|
+
*/
|
|
34
37
|
get: operations["Index"];
|
|
35
38
|
put?: never;
|
|
36
39
|
post?: never;
|
|
@@ -101,6 +104,150 @@ export interface paths {
|
|
|
101
104
|
patch?: never;
|
|
102
105
|
trace?: never;
|
|
103
106
|
};
|
|
107
|
+
"/discover/websites": {
|
|
108
|
+
parameters: {
|
|
109
|
+
query?: never;
|
|
110
|
+
header?: never;
|
|
111
|
+
path?: never;
|
|
112
|
+
cookie?: never;
|
|
113
|
+
};
|
|
114
|
+
/**
|
|
115
|
+
* Suggest websites for the Discover flow
|
|
116
|
+
* @description Website-first autocomplete that backs the Discover home page (`/`). Returns the distinct websites (one entry per domain) that have at least one verification the caller can see, ranked by relevance to `q`. Each entry carries the aggregated list of data points provable for that website. With no `q`, returns popular websites (most verifications first).
|
|
117
|
+
*
|
|
118
|
+
* HTML / HTMX callers receive a fragment list (swapped into the search dropdown); JSON / SDK callers receive the suggestions document.
|
|
119
|
+
*/
|
|
120
|
+
get: operations["DiscoverWebsites"];
|
|
121
|
+
put?: never;
|
|
122
|
+
post?: never;
|
|
123
|
+
delete?: never;
|
|
124
|
+
options?: never;
|
|
125
|
+
head?: never;
|
|
126
|
+
patch?: never;
|
|
127
|
+
trace?: never;
|
|
128
|
+
};
|
|
129
|
+
"/site/{domain}": {
|
|
130
|
+
parameters: {
|
|
131
|
+
query?: never;
|
|
132
|
+
header?: never;
|
|
133
|
+
path?: never;
|
|
134
|
+
cookie?: never;
|
|
135
|
+
};
|
|
136
|
+
/**
|
|
137
|
+
* Website landing & data-point selection page
|
|
138
|
+
* @description SEO landing page for a website, and the data-point selection step of the Discover flow. Lists every data point Reclaim can currently prove for `{domain}` (aggregated across all verifications the caller can see) so a visitor can pick what to verify and continue. Organic search traffic ("verify github username") and the in-app `/` → website-select flow converge on this single canonical URL.
|
|
139
|
+
*
|
|
140
|
+
* HTML callers receive the full page; when `q` is present and the request is an HTMX request, only the filtered data-point list fragment is returned. JSON / SDK callers receive the website's data points as a document.
|
|
141
|
+
*/
|
|
142
|
+
get: operations["SitePage"];
|
|
143
|
+
put?: never;
|
|
144
|
+
post?: never;
|
|
145
|
+
delete?: never;
|
|
146
|
+
options?: never;
|
|
147
|
+
head?: never;
|
|
148
|
+
patch?: never;
|
|
149
|
+
trace?: never;
|
|
150
|
+
};
|
|
151
|
+
"/site/{domain}/panel": {
|
|
152
|
+
parameters: {
|
|
153
|
+
query?: never;
|
|
154
|
+
header?: never;
|
|
155
|
+
path?: never;
|
|
156
|
+
cookie?: never;
|
|
157
|
+
};
|
|
158
|
+
/**
|
|
159
|
+
* Discover summary panel fragment (htmx)
|
|
160
|
+
* @description HTMX-only fragment for the Discover site page. The data-point form fires this on every selection change (checkbox / mode / source pin), carrying the whole selection in the query string. Returns the summary panel aside (the swap target) plus an out-of-band swap of the Advanced source picker.
|
|
161
|
+
*/
|
|
162
|
+
get: operations["SitePanel"];
|
|
163
|
+
put?: never;
|
|
164
|
+
post?: never;
|
|
165
|
+
delete?: never;
|
|
166
|
+
options?: never;
|
|
167
|
+
head?: never;
|
|
168
|
+
patch?: never;
|
|
169
|
+
trace?: never;
|
|
170
|
+
};
|
|
171
|
+
"/site/{domain}/build": {
|
|
172
|
+
parameters: {
|
|
173
|
+
query?: never;
|
|
174
|
+
header?: never;
|
|
175
|
+
path?: never;
|
|
176
|
+
cookie?: never;
|
|
177
|
+
};
|
|
178
|
+
/**
|
|
179
|
+
* Build page — providers, try, and integration guide for a selection
|
|
180
|
+
* @description The step after data-point selection on `/site/{domain}`. Given the selected data points (plus optional pinned sources, provided values, and a resolution `mode`), shows which existing verification providers cover the selection, a member-only "Try verification" action, and a ready-to-paste integration guide. The whole selection travels in the query string so the page is server-rendered and back-navigable.
|
|
181
|
+
*/
|
|
182
|
+
get: operations["SiteBuild"];
|
|
183
|
+
put?: never;
|
|
184
|
+
post?: never;
|
|
185
|
+
delete?: never;
|
|
186
|
+
options?: never;
|
|
187
|
+
head?: never;
|
|
188
|
+
patch?: never;
|
|
189
|
+
trace?: never;
|
|
190
|
+
};
|
|
191
|
+
"/site/{domain}/try": {
|
|
192
|
+
parameters: {
|
|
193
|
+
query?: never;
|
|
194
|
+
header?: never;
|
|
195
|
+
path?: never;
|
|
196
|
+
cookie?: never;
|
|
197
|
+
};
|
|
198
|
+
get?: never;
|
|
199
|
+
put?: never;
|
|
200
|
+
/**
|
|
201
|
+
* Mint a SANDBOX test verification session for the selection
|
|
202
|
+
* @description Creates a real SANDBOX verification session under the signed-in member's personal organization for the selected data points, so they can test the flow on `/v/{sessionId}` without registering a callback subscription. Requires a signed-in member (session cookie); the provider set is recomputed server-side from the selection.
|
|
203
|
+
*/
|
|
204
|
+
post: operations["SiteBuildTry"];
|
|
205
|
+
delete?: never;
|
|
206
|
+
options?: never;
|
|
207
|
+
head?: never;
|
|
208
|
+
patch?: never;
|
|
209
|
+
trace?: never;
|
|
210
|
+
};
|
|
211
|
+
"/discover/teach": {
|
|
212
|
+
parameters: {
|
|
213
|
+
query?: never;
|
|
214
|
+
header?: never;
|
|
215
|
+
path?: never;
|
|
216
|
+
cookie?: never;
|
|
217
|
+
};
|
|
218
|
+
/**
|
|
219
|
+
* “Teach our agent” instructions for a missing website / data point
|
|
220
|
+
* @description Returns the "Teach our agent" panel shown when a website or data point a user wants does not exist yet: steps to install the Reclaim MCP server plus a ready-to-copy prompt, templated with the requested `domain` and (optionally) `dataPoint`, that instructs an agent to author the missing verification. HTML / HTMX only (a dialog fragment).
|
|
221
|
+
*/
|
|
222
|
+
get: operations["DiscoverTeachAgent"];
|
|
223
|
+
put?: never;
|
|
224
|
+
post?: never;
|
|
225
|
+
delete?: never;
|
|
226
|
+
options?: never;
|
|
227
|
+
head?: never;
|
|
228
|
+
patch?: never;
|
|
229
|
+
trace?: never;
|
|
230
|
+
};
|
|
231
|
+
"/discover/resolve": {
|
|
232
|
+
parameters: {
|
|
233
|
+
query?: never;
|
|
234
|
+
header?: never;
|
|
235
|
+
path?: never;
|
|
236
|
+
cookie?: never;
|
|
237
|
+
};
|
|
238
|
+
/**
|
|
239
|
+
* Resolve existing providers covering selected data points
|
|
240
|
+
* @description The "resolve" step behind the Discover CTAs. Given a website and the data points the user picked, returns the existing verifications on that domain whose data points COVER the whole selection (smallest / most specific first), so a caller can reuse one instead of building a new verification. When nothing covers the selection, `needsCreation` is `true` — synthesising a new provider by stitching is a later stage. JSON only.
|
|
241
|
+
*/
|
|
242
|
+
get: operations["DiscoverResolve"];
|
|
243
|
+
put?: never;
|
|
244
|
+
post?: never;
|
|
245
|
+
delete?: never;
|
|
246
|
+
options?: never;
|
|
247
|
+
head?: never;
|
|
248
|
+
patch?: never;
|
|
249
|
+
trace?: never;
|
|
250
|
+
};
|
|
104
251
|
"/providers/{providerId}/preview.png": {
|
|
105
252
|
parameters: {
|
|
106
253
|
query?: never;
|
|
@@ -392,6 +539,26 @@ export interface paths {
|
|
|
392
539
|
patch?: never;
|
|
393
540
|
trace?: never;
|
|
394
541
|
};
|
|
542
|
+
"/v/{sessionId}/dispose": {
|
|
543
|
+
parameters: {
|
|
544
|
+
query?: never;
|
|
545
|
+
header?: never;
|
|
546
|
+
path?: never;
|
|
547
|
+
cookie?: never;
|
|
548
|
+
};
|
|
549
|
+
get?: never;
|
|
550
|
+
put?: never;
|
|
551
|
+
/**
|
|
552
|
+
* Dispose the session's remote browser
|
|
553
|
+
* @description Tears down the Popcorn remote-browser session backing this verification and cancels any in-flight run. Called by the verification page's "close" button (and safe to call after a session is already terminal — the dispose is idempotent). Popcorn sessions are a scarce, expensive resource, so freeing them promptly rather than waiting for their TTL matters. Same model as the status fragment: possession of the session id; no body.
|
|
554
|
+
*/
|
|
555
|
+
post: operations["DisposeVerificationSession"];
|
|
556
|
+
delete?: never;
|
|
557
|
+
options?: never;
|
|
558
|
+
head?: never;
|
|
559
|
+
patch?: never;
|
|
560
|
+
trace?: never;
|
|
561
|
+
};
|
|
395
562
|
"/v/{sessionId}/sse": {
|
|
396
563
|
parameters: {
|
|
397
564
|
query?: never;
|
|
@@ -563,8 +730,7 @@ export interface paths {
|
|
|
563
730
|
delete?: never;
|
|
564
731
|
options?: never;
|
|
565
732
|
head?: never;
|
|
566
|
-
|
|
567
|
-
patch: operations["UpdateMe"];
|
|
733
|
+
patch?: never;
|
|
568
734
|
trace?: never;
|
|
569
735
|
};
|
|
570
736
|
"/users/{userId}": {
|
|
@@ -640,7 +806,11 @@ export interface paths {
|
|
|
640
806
|
path?: never;
|
|
641
807
|
cookie?: never;
|
|
642
808
|
};
|
|
643
|
-
|
|
809
|
+
/**
|
|
810
|
+
* List organization members, optionally filtered by email
|
|
811
|
+
* @description Returns the organization's members, optionally filtered by an email substring (`q`). Renders the members-list fragment for the org page's live filter; same visibility as the org page.
|
|
812
|
+
*/
|
|
813
|
+
get: operations["SearchOrgMembers"];
|
|
644
814
|
put?: never;
|
|
645
815
|
/**
|
|
646
816
|
* Invite a member to an organization
|
|
@@ -738,7 +908,7 @@ export interface paths {
|
|
|
738
908
|
patch: operations["UpdateTheme"];
|
|
739
909
|
trace?: never;
|
|
740
910
|
};
|
|
741
|
-
"/orgs/{orgId}/
|
|
911
|
+
"/orgs/{orgId}/keypair": {
|
|
742
912
|
parameters: {
|
|
743
913
|
query?: never;
|
|
744
914
|
header?: never;
|
|
@@ -746,21 +916,21 @@ export interface paths {
|
|
|
746
916
|
cookie?: never;
|
|
747
917
|
};
|
|
748
918
|
/**
|
|
749
|
-
* Get the organization's encryption
|
|
750
|
-
* @description Returns the organization's single
|
|
919
|
+
* Get the organization's encryption keypair
|
|
920
|
+
* @description Returns the organization's single Ethereum (secp256k1) encryption keypair — its public JWK, derived eth address, and `canEncryptResult` flag — or `404` when none is set (the org is keyless ⇒ plaintext delivery). Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
|
|
751
921
|
*/
|
|
752
|
-
get: operations["
|
|
922
|
+
get: operations["GetOrgKeypair"];
|
|
753
923
|
/**
|
|
754
|
-
* Set (or
|
|
755
|
-
* @description Upserts the organization's single
|
|
924
|
+
* Set (or rotate) the organization's encryption keypair
|
|
925
|
+
* @description Upserts the organization's single Ethereum (secp256k1) encryption keypair. The body carries the org's **eth public key** — as an uncompressed hex string (`0x04`+128 hex) or a secp256k1 public JWK (`{kty:'EC', crv:'secp256k1', x, y}`) — and `canEncryptResult`. The matching private key never leaves the consumer. Setting overwrites the single row (and creates it for a keyless org). When `canEncryptResult` is true, terminal results are delivered as an ECIES ciphertext encrypted to this key; otherwise plaintext. Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
|
|
756
926
|
*/
|
|
757
|
-
put: operations["
|
|
927
|
+
put: operations["SetOrgKeypair"];
|
|
758
928
|
post?: never;
|
|
759
929
|
/**
|
|
760
|
-
* Clear the organization's encryption
|
|
761
|
-
* @description Removes the organization's encryption
|
|
930
|
+
* Clear the organization's encryption keypair
|
|
931
|
+
* @description Removes the organization's encryption keypair (the org reverts to keyless ⇒ plaintext delivery, and loses its eth identity address) until a new keypair is set. Authenticated by the org's `OrgToken` or a human `BearerAuth` session for an active member of the org.
|
|
762
932
|
*/
|
|
763
|
-
delete: operations["
|
|
933
|
+
delete: operations["DeleteOrgKeypair"];
|
|
764
934
|
options?: never;
|
|
765
935
|
head?: never;
|
|
766
936
|
patch?: never;
|
|
@@ -878,6 +1048,26 @@ export interface paths {
|
|
|
878
1048
|
patch?: never;
|
|
879
1049
|
trace?: never;
|
|
880
1050
|
};
|
|
1051
|
+
"/attach": {
|
|
1052
|
+
parameters: {
|
|
1053
|
+
query?: never;
|
|
1054
|
+
header?: never;
|
|
1055
|
+
path?: never;
|
|
1056
|
+
cookie?: never;
|
|
1057
|
+
};
|
|
1058
|
+
/**
|
|
1059
|
+
* Device-pairing landing page
|
|
1060
|
+
* @description Page where a user enters the 5-character pairing code shown by their CLI / MCP. Submitting the form (`?code=`) redirects to the canonical `/attach/{code}` page; an invalid code re-renders the form with an error.
|
|
1061
|
+
*/
|
|
1062
|
+
get: operations["AttachLanding"];
|
|
1063
|
+
put?: never;
|
|
1064
|
+
post?: never;
|
|
1065
|
+
delete?: never;
|
|
1066
|
+
options?: never;
|
|
1067
|
+
head?: never;
|
|
1068
|
+
patch?: never;
|
|
1069
|
+
trace?: never;
|
|
1070
|
+
};
|
|
881
1071
|
"/attach/{code}": {
|
|
882
1072
|
parameters: {
|
|
883
1073
|
query?: never;
|
|
@@ -1194,9 +1384,9 @@ export interface paths {
|
|
|
1194
1384
|
* the presented `OrgToken` resolves to. The body is just `callbackUrl`
|
|
1195
1385
|
* and `events`. At least one subscription must exist for the org before a
|
|
1196
1386
|
* verification session can be created. Delivery is scoped by org: terminal
|
|
1197
|
-
* results are encrypted
|
|
1198
|
-
*
|
|
1199
|
-
* as plaintext.
|
|
1387
|
+
* results are ECIES-encrypted to the org's eth public key when its
|
|
1388
|
+
* `canEncryptResult` is enabled (see `PUT /orgs/{orgId}/keypair`), else
|
|
1389
|
+
* delivered as plaintext.
|
|
1200
1390
|
*/
|
|
1201
1391
|
post: operations["CreateCallbackSubscription"];
|
|
1202
1392
|
delete?: never;
|
|
@@ -1390,8 +1580,8 @@ export interface paths {
|
|
|
1390
1580
|
cookie?: never;
|
|
1391
1581
|
};
|
|
1392
1582
|
/**
|
|
1393
|
-
* Get the resolved provider
|
|
1394
|
-
* @description Returns the resolved provider
|
|
1583
|
+
* Get the resolved provider recipes for a session
|
|
1584
|
+
* @description Returns the session's resolved provider versions' recipes (`initialUrl` + `requests` per provider), in run order — what the Verification Client needs to run the session (each provider sequentially in one browser session). Authorized for the Verification Client (`X-VC-Token` service token) or the session creator (authenticated by the consumer's `OrgToken`; the resolved org must match the session), so it works regardless of the provider's visibility (unlike `GetProvider`, which 404s on PRIVATE providers for non-members).
|
|
1395
1585
|
*/
|
|
1396
1586
|
get: operations["GetVerificationRecipe"];
|
|
1397
1587
|
put?: never;
|
|
@@ -1500,7 +1690,7 @@ export interface paths {
|
|
|
1500
1690
|
};
|
|
1501
1691
|
/**
|
|
1502
1692
|
* List callback encryption keys for a session
|
|
1503
|
-
* @description Used by the Verification Client (X-VC-Token) after the terminal event: returns the session org's callback subscriptions that subscribe to that terminal event. Each item carries the org's `publicKeyJwk` (
|
|
1693
|
+
* @description Used by the Verification Client (X-VC-Token) after the terminal event: returns the session org's callback subscriptions that subscribe to that terminal event. Each item carries the org's `publicKeyJwk` (secp256k1) to ECIES-encrypt the result to when the org's `canEncryptResult` is enabled, or none (deliver plaintext).
|
|
1504
1694
|
*/
|
|
1505
1695
|
get: operations["ListSessionCallbackKeys"];
|
|
1506
1696
|
put?: never;
|
|
@@ -1526,7 +1716,7 @@ export interface paths {
|
|
|
1526
1716
|
put?: never;
|
|
1527
1717
|
/**
|
|
1528
1718
|
* Submit the signed, encrypted verification result
|
|
1529
|
-
* @description Used by the Verification Client (X-VC-Token) to submit the result after a terminal event. The VC signs the JWS and
|
|
1719
|
+
* @description Used by the Verification Client (X-VC-Token) to submit the result after a terminal event. The VC signs the JWS and, when the org's `canEncryptResult` is enabled, ECIES-encrypts it to the org's eth public key (from the callback-keys endpoint); it submits one payload per subscription. The Builder stores each payload, enqueues it for the delivery worker (retry → DLQ), and never sees the plaintext. The Verification Client does not contact the Consumer.
|
|
1530
1720
|
*/
|
|
1531
1721
|
post: operations["SubmitVerificationResult"];
|
|
1532
1722
|
delete?: never;
|
|
@@ -1617,18 +1807,18 @@ export interface webhooks {
|
|
|
1617
1807
|
* `timestamp` are *plaintext routing hints* so the consumer can
|
|
1618
1808
|
* route and dedupe before doing any crypto. Everything derived
|
|
1619
1809
|
* from the end-user (claims, extracted parameters, proofs,
|
|
1620
|
-
* context) is inside `data`:
|
|
1621
|
-
* result when the org
|
|
1810
|
+
* context) is inside `data`: an ECIES ciphertext wrapping the signed JWS
|
|
1811
|
+
* result when the org's `canEncryptResult` is enabled, else the
|
|
1622
1812
|
* plaintext signed JWS. The envelope is **not authenticated** —
|
|
1623
1813
|
* act only on the decrypted and signature-verified JWS contents,
|
|
1624
1814
|
* and check that its `reclaimSessionId` matches the session you
|
|
1625
1815
|
* expect.
|
|
1626
1816
|
*
|
|
1627
|
-
* **Decrypting `data`.** When the org
|
|
1628
|
-
*
|
|
1629
|
-
*
|
|
1630
|
-
*
|
|
1631
|
-
*
|
|
1817
|
+
* **Decrypting `data`.** When the org's `canEncryptResult` is enabled,
|
|
1818
|
+
* `data` is an ECIES ciphertext (base64url, secp256k1 + AES-256-GCM);
|
|
1819
|
+
* decrypt it with the matching eth private key to recover the inner
|
|
1820
|
+
* JWS. When the org is keyless or the flag is off, `data` is the JWS
|
|
1821
|
+
* directly.
|
|
1632
1822
|
* The JWS is an RFC 7515 result in General JSON serialization
|
|
1633
1823
|
* (`alg: ES256K`); verify it against
|
|
1634
1824
|
* `GET /.well-known/jwks.json` (`kid` = the signer's ETH address).
|
|
@@ -1855,8 +2045,8 @@ export interface components {
|
|
|
1855
2045
|
providers?: components["schemas"]["ProviderListItem"][];
|
|
1856
2046
|
/** @description Themes owned by this organization. */
|
|
1857
2047
|
themes?: components["schemas"]["Theme"][];
|
|
1858
|
-
/** @description The organization's single
|
|
1859
|
-
|
|
2048
|
+
/** @description The organization's single Ethereum (secp256k1) encryption keypair, if set. Only populated on the org-detail endpoint and only visible to active members. Absent ⇒ the org is keyless and results are delivered as plaintext. */
|
|
2049
|
+
keypair?: components["schemas"]["OrgKeypair"];
|
|
1860
2050
|
/** @description Billing record attached to the org, if any. Owner-visible only; absent for members. Presence promotes the org to production mode. */
|
|
1861
2051
|
billing?: components["schemas"]["OrgBilling"];
|
|
1862
2052
|
createMetadata: components["schemas"]["ActorMetadata"];
|
|
@@ -1887,26 +2077,43 @@ export interface components {
|
|
|
1887
2077
|
*/
|
|
1888
2078
|
status: components["schemas"]["EntityStatus"];
|
|
1889
2079
|
};
|
|
1890
|
-
/** @description
|
|
1891
|
-
|
|
2080
|
+
/** @description A secp256k1 (Ethereum) public key in JWK form (`{kty:'EC', crv:'secp256k1', x, y}`), used to ECIES-encrypt delivered verification results and to identify the org. The matching private key never leaves the consumer. Same shape published by the signing JWKS. */
|
|
2081
|
+
JwkSecp256k1Public: {
|
|
1892
2082
|
/** @enum {string} */
|
|
1893
|
-
kty: "
|
|
2083
|
+
kty: "EC";
|
|
1894
2084
|
/** @enum {string} */
|
|
1895
|
-
crv: "
|
|
1896
|
-
/** @description base64url-encoded
|
|
2085
|
+
crv: "secp256k1";
|
|
2086
|
+
/** @description base64url-encoded X coordinate (32 bytes). */
|
|
1897
2087
|
x: string;
|
|
1898
|
-
|
|
1899
|
-
|
|
1900
|
-
|
|
1901
|
-
|
|
1902
|
-
|
|
2088
|
+
/** @description base64url-encoded Y coordinate (32 bytes). */
|
|
2089
|
+
y: string;
|
|
2090
|
+
};
|
|
2091
|
+
/** @description An organization's single Ethereum (secp256k1) encryption keypair: the public JWK, its derived eth address (which also identifies the org), and the `canEncryptResult` toggle. One per org, set/rotated via `PUT /orgs/{orgId}/keypair`. Absent ⇒ the org is keyless (plaintext delivery). */
|
|
2092
|
+
OrgKeypair: {
|
|
2093
|
+
publicKeyJwk: components["schemas"]["JwkSecp256k1Public"];
|
|
2094
|
+
/** @description Lowercase 0x eth address derived from the public key. */
|
|
2095
|
+
ethAddress: string;
|
|
2096
|
+
/** @description When true, terminal results are ECIES-encrypted to this key; when false (the default), they are delivered as plaintext. */
|
|
2097
|
+
canEncryptResult: boolean;
|
|
2098
|
+
/** @description Optional human-readable label set when the keypair was stored. */
|
|
1903
2099
|
label?: string;
|
|
1904
2100
|
createMetadata: components["schemas"]["ActorMetadata"];
|
|
1905
2101
|
updateMetadata: components["schemas"]["ActorMetadata"];
|
|
1906
2102
|
};
|
|
1907
|
-
|
|
1908
|
-
|
|
1909
|
-
|
|
2103
|
+
OrgKeypairRequest: components["schemas"]["OrgKeypairHexRequest"] | components["schemas"]["OrgKeypairJwkRequest"];
|
|
2104
|
+
/** @description Body for `PUT /orgs/{orgId}/keypair`. Carries the org's eth public key as an uncompressed hex string (`0x04` + 128 hex) — the eth-native form wallets/ethers emit. The matching private key never leaves the consumer. */
|
|
2105
|
+
OrgKeypairHexRequest: {
|
|
2106
|
+
/** @description Uncompressed secp256k1 public key, `0x04` + 128 hex. */
|
|
2107
|
+
publicKey: string;
|
|
2108
|
+
/** @default false */
|
|
2109
|
+
canEncryptResult: boolean;
|
|
2110
|
+
label?: string;
|
|
2111
|
+
};
|
|
2112
|
+
/** @description Body for `PUT /orgs/{orgId}/keypair`. Carries the org's eth public key as a secp256k1 public JWK. */
|
|
2113
|
+
OrgKeypairJwkRequest: {
|
|
2114
|
+
publicKeyJwk: components["schemas"]["JwkSecp256k1Public"];
|
|
2115
|
+
/** @default false */
|
|
2116
|
+
canEncryptResult: boolean;
|
|
1910
2117
|
label?: string;
|
|
1911
2118
|
};
|
|
1912
2119
|
/** @description Response of `POST /orgs/{orgId}/token`. The plaintext `orgSecret` is shown **only once** here; the server stores only its HMAC. Use it as `Authorization: Bearer <orgSecret>` (the `OrgToken` scheme). */
|
|
@@ -1992,8 +2199,10 @@ export interface components {
|
|
|
1992
2199
|
writeRedactionMode?: components["schemas"]["WriteRedactionMode"];
|
|
1993
2200
|
/** @description Apply TLS configuration when creating the tunnel to the attestor. */
|
|
1994
2201
|
additionalClientOptions?: components["schemas"]["AdditionalTlsClientOptions"];
|
|
1995
|
-
/** @description
|
|
1996
|
-
|
|
2202
|
+
/** @description Conditions the (redacted) response must satisfy for the proof to be valid. Each runs against the union of the portions revealed by `responseRedactions` (or the whole response when there are none). Mirrors attestor-core `responseMatches`. */
|
|
2203
|
+
responseMatches?: components["schemas"]["ResponseMatch"][];
|
|
2204
|
+
/** @description Portions to select/reveal from the response, applied in order (xPath => jsonPath => regex). Done client-side; only the selected portions (plus the first response line) are sent to the attestor. An independent ordered list — NOT paired 1:1 with `responseMatches`. Mirrors attestor-core `responseRedactions`. */
|
|
2205
|
+
responseRedactions?: components["schemas"]["ResponseRedaction"][];
|
|
1997
2206
|
};
|
|
1998
2207
|
/** @description A template for selecting request */
|
|
1999
2208
|
RequestSelectionTemplate: components["schemas"]["RequestSelection"] & {
|
|
@@ -2041,11 +2250,9 @@ export interface components {
|
|
|
2041
2250
|
type: "regex" | "contains";
|
|
2042
2251
|
/** @description The pattern or value to look for in the response. When `type` is 'contains', supports template variable declaration using `{{variable}}` syntax. When `type` is 'regex', can be used to extract variables using regex named groups. */
|
|
2043
2252
|
value: string;
|
|
2044
|
-
/** @description Optional extractor describing which portion of the response to pin to the proof. When absent, the match runs against the raw response body. */
|
|
2045
|
-
extract?: components["schemas"]["ExtractDataSpecifier"];
|
|
2046
2253
|
};
|
|
2047
2254
|
/** @description Which portions to select from a response. These are selected in order, xpath => jsonPath => regex * These redactions are done client side and only the selected portions are sent to the attestor. The attestor will only be able to see the selected portions alongside the first line of the HTTP response (i.e. "HTTP/1.1 200 OK") */
|
|
2048
|
-
|
|
2255
|
+
ResponseRedaction: {
|
|
2049
2256
|
/** @description expect an HTML response, and to contain a certain xpath for eg. "/html/body/div.a1/div.a2/span.a5" */
|
|
2050
2257
|
xPath?: string;
|
|
2051
2258
|
/** @description expect a JSON response, retrieve the item at this path using dot notation for e.g. 'email.addresses.0' */
|
|
@@ -2221,6 +2428,43 @@ export interface components {
|
|
|
2221
2428
|
primaryDataPoint?: string;
|
|
2222
2429
|
dataPoints: string[];
|
|
2223
2430
|
};
|
|
2431
|
+
/** @description One website (distinct domain) in the Discover search results. Aggregates, across every verification the caller can see on that domain, the brand display fields and the union of provable data points. */
|
|
2432
|
+
WebsiteSuggestion: {
|
|
2433
|
+
/**
|
|
2434
|
+
* Format: hostname
|
|
2435
|
+
* @description Canonical root domain (e.g. `github.com`).
|
|
2436
|
+
*/
|
|
2437
|
+
domain: string;
|
|
2438
|
+
/** @description Display name for the website (scraped site name or derived from the domain). */
|
|
2439
|
+
brandName: string;
|
|
2440
|
+
/**
|
|
2441
|
+
* Format: uri
|
|
2442
|
+
* @description Favicon URL for the website.
|
|
2443
|
+
*/
|
|
2444
|
+
iconUrl?: string;
|
|
2445
|
+
/** @description Deduplicated names of every data point provable for this website. */
|
|
2446
|
+
dataPoints: string[];
|
|
2447
|
+
/** @description Number of verifications backing this website that the caller can see. */
|
|
2448
|
+
providerCount: number;
|
|
2449
|
+
};
|
|
2450
|
+
/** @description Body for `POST /site/{domain}/try`. Only the verification `context` (values for the resolved providers' `requiredContext` inputs). The selection (dataPoints / mode / pins) travels in the query string. */
|
|
2451
|
+
SiteBuildTryBody: {
|
|
2452
|
+
/** @description Input key → value the consumer's app supplies. */
|
|
2453
|
+
context?: {
|
|
2454
|
+
[key: string]: string;
|
|
2455
|
+
};
|
|
2456
|
+
};
|
|
2457
|
+
/** @description A single data point selectable on the `/site/{domain}` page, with how many visible verifications expose it and one example verification slug. */
|
|
2458
|
+
DataPointItem: {
|
|
2459
|
+
/** @description Data-point name (e.g. `username`, `followers_count`). */
|
|
2460
|
+
name: string;
|
|
2461
|
+
/** @description Human description of the data point, taken from the response match that declares it. Absent when no match supplies one. */
|
|
2462
|
+
description?: string;
|
|
2463
|
+
/** @description Number of visible verifications on the domain that expose this data point. */
|
|
2464
|
+
providerCount: number;
|
|
2465
|
+
/** @description Slug of one verification that exposes this data point. */
|
|
2466
|
+
exampleProviderSlug?: string;
|
|
2467
|
+
};
|
|
2224
2468
|
InterceptorOptions: {
|
|
2225
2469
|
/**
|
|
2226
2470
|
* @description How traffic interception is implemented.
|
|
@@ -2411,12 +2655,16 @@ export interface components {
|
|
|
2411
2655
|
/** @description Opaque bearer token. Send as `Authorization: Bearer <token>` on every authenticated request. */
|
|
2412
2656
|
token: string;
|
|
2413
2657
|
};
|
|
2414
|
-
/** @description
|
|
2415
|
-
UpdateUserRequest: {
|
|
2416
|
-
name?: string;
|
|
2417
|
-
};
|
|
2658
|
+
/** @description Body for `POST /orgs`. Explicitly-created orgs must declare their Ethereum (secp256k1) encryption public key — it identifies the org and, when `canEncryptResult` is enabled, encrypts delivered results. */
|
|
2418
2659
|
CreateOrgRequest: {
|
|
2419
2660
|
name: string;
|
|
2661
|
+
/** @description The org's eth public key, uncompressed hex (`0x04` + 128 hex) — the eth-native form wallets/ethers emit. The matching private key never leaves the consumer. */
|
|
2662
|
+
publicKey: string;
|
|
2663
|
+
/**
|
|
2664
|
+
* @description When true, terminal results are ECIES-encrypted to this key; when false (the default), they are delivered as plaintext.
|
|
2665
|
+
* @default false
|
|
2666
|
+
*/
|
|
2667
|
+
canEncryptResult: boolean;
|
|
2420
2668
|
};
|
|
2421
2669
|
UpdateOrgRequest: {
|
|
2422
2670
|
name?: string;
|
|
@@ -2606,9 +2854,10 @@ export interface components {
|
|
|
2606
2854
|
* @description Lifecycle event reported for a verification session. A healthy run
|
|
2607
2855
|
* proceeds through these in order; reading the gaps locates where a
|
|
2608
2856
|
* session stalled. Session-level terminal events trigger callback
|
|
2609
|
-
* delivery; request-level events are progress pings carrying a
|
|
2610
|
-
* `
|
|
2611
|
-
* clients MUST tolerate unknown
|
|
2857
|
+
* delivery; provider-/request-level events are progress pings carrying a
|
|
2858
|
+
* `provider_id` (and `request_id` for request-level ones) in their event
|
|
2859
|
+
* data. New values may be added over time; clients MUST tolerate unknown
|
|
2860
|
+
* values in responses.
|
|
2612
2861
|
*
|
|
2613
2862
|
* - `session_pending`: Session created; awaiting the end-user.
|
|
2614
2863
|
*
|
|
@@ -2617,6 +2866,10 @@ export interface components {
|
|
|
2617
2866
|
*
|
|
2618
2867
|
* - `verification_client_ready`: The client initialized.
|
|
2619
2868
|
*
|
|
2869
|
+
* - `verification_provider_started`: The client began verifying a provider
|
|
2870
|
+
* (`provider_id`/`resolved_version`/`ordinal` in `eventData`). One per
|
|
2871
|
+
* provider, in run order, for multi-provider sessions.
|
|
2872
|
+
*
|
|
2620
2873
|
* - `request_matched`: The target request was captured on the provider
|
|
2621
2874
|
* site. Absent (after opened) ⇒ the user didn't complete the journey.
|
|
2622
2875
|
*
|
|
@@ -2637,7 +2890,7 @@ export interface components {
|
|
|
2637
2890
|
* - `session_expired`: `expiresAt` passed before a terminal event.
|
|
2638
2891
|
* @enum {string}
|
|
2639
2892
|
*/
|
|
2640
|
-
VerificationEvent: "session_pending" | "verification_client_opened" | "verification_client_ready" | "request_matched" | "request_claim_created" | "request_claim_completed" | "request_claim_rejected" | "request_claim_failed" | "verification_success" | "verification_rejected" | "verification_error" | "session_expired";
|
|
2893
|
+
VerificationEvent: "session_pending" | "verification_client_opened" | "verification_client_ready" | "verification_provider_started" | "request_matched" | "request_claim_created" | "request_claim_completed" | "request_claim_rejected" | "request_claim_failed" | "verification_success" | "verification_rejected" | "verification_error" | "session_expired";
|
|
2641
2894
|
/**
|
|
2642
2895
|
* @description Status of a verification session, derived from its events. New values
|
|
2643
2896
|
* may be added over time; clients MUST tolerate unknown values in
|
|
@@ -2674,7 +2927,7 @@ export interface components {
|
|
|
2674
2927
|
* @enum {string}
|
|
2675
2928
|
*/
|
|
2676
2929
|
CallbackDeliveryStatus: "pending" | "delivered" | "attempt_failed" | "failed";
|
|
2677
|
-
/** @description A pre-registered destination for verification results, owned by an organization. A session's results go to every subscription on the session's org whose `events` include the terminal event. At least one subscription must exist for the org before a session can be created. Terminal results are encrypted
|
|
2930
|
+
/** @description A pre-registered destination for verification results, owned by an organization. A session's results go to every subscription on the session's org whose `events` include the terminal event. At least one subscription must exist for the org before a session can be created. Terminal results are ECIES-encrypted to the org's eth public key when its `canEncryptResult` is enabled (see `OrgKeypair`), else delivered as plaintext. */
|
|
2678
2931
|
CallbackSubscription: {
|
|
2679
2932
|
/** Format: uuid */
|
|
2680
2933
|
id: string;
|
|
@@ -2717,11 +2970,8 @@ export interface components {
|
|
|
2717
2970
|
* @description UUID v7 session id (also echoed in context as `reclaimSessionId`).
|
|
2718
2971
|
*/
|
|
2719
2972
|
id: string;
|
|
2720
|
-
|
|
2721
|
-
|
|
2722
|
-
version?: string;
|
|
2723
|
-
/** @description Exact version resolved at creation time. */
|
|
2724
|
-
resolvedVersion: string;
|
|
2973
|
+
/** @description The providers this session verifies, in run order. The Verification Client runs each (sequentially, in one browser session) and submits one combined result; all are required. */
|
|
2974
|
+
providers: components["schemas"]["SessionProvider"][];
|
|
2725
2975
|
/** @description The organization that owns this session. */
|
|
2726
2976
|
orgId?: components["schemas"]["OrgID"];
|
|
2727
2977
|
/**
|
|
@@ -2748,16 +2998,29 @@ export interface components {
|
|
|
2748
2998
|
mode: components["schemas"]["CredentialMode"];
|
|
2749
2999
|
sandboxLimits?: components["schemas"]["SandboxLimits"];
|
|
2750
3000
|
};
|
|
2751
|
-
/** @description
|
|
2752
|
-
|
|
3001
|
+
/** @description One provider a session verifies, with its resolved version. */
|
|
3002
|
+
SessionProvider: {
|
|
3003
|
+
providerId: components["schemas"]["ProviderID"];
|
|
3004
|
+
/** @description Version constraint requested by the Consumer (empty = latest). */
|
|
3005
|
+
version?: string;
|
|
3006
|
+
/** @description Exact version resolved at creation time. */
|
|
3007
|
+
resolvedVersion: string;
|
|
3008
|
+
};
|
|
3009
|
+
/** @description A provider (+ optional version) to verify in a session. */
|
|
3010
|
+
SessionProviderInput: {
|
|
2753
3011
|
providerId: components["schemas"]["ProviderID"];
|
|
2754
3012
|
/** @description Semver constraint; empty resolves to the latest trunk version. */
|
|
2755
3013
|
version?: string;
|
|
2756
|
-
|
|
3014
|
+
};
|
|
3015
|
+
/** @description Body for `POST /verifications/sessions`. Authenticated by the consumer's `OrgToken`. Carries no callback URLs — they come from the org's callback subscriptions. The one shared `context` is validated against every provider's `requiredContext`. */
|
|
3016
|
+
CreateVerificationSessionRequest: {
|
|
3017
|
+
/** @description Providers to verify, in run order. The Verification Client runs each sequentially in one browser session and submits one combined result; all are required. */
|
|
3018
|
+
providers: components["schemas"]["SessionProviderInput"][];
|
|
3019
|
+
/** @description Consumer context, shared by all providers. Validated against EACH resolved provider version's `requiredContext` JSON Schema (a 400 is returned on mismatch); extra fields are always allowed. Recipe requests reference these values as `{{context.<key>}}`. Echoed back (plus `reclaimSessionId`) in the result. */
|
|
2757
3020
|
context: {
|
|
2758
3021
|
[key: string]: unknown;
|
|
2759
3022
|
};
|
|
2760
|
-
/** @description Must contain a `{sessionId}` placeholder. */
|
|
3023
|
+
/** @description Must contain a `{sessionId}` placeholder. Must be an http(s) URL. */
|
|
2761
3024
|
verificationClientUrl: string;
|
|
2762
3025
|
};
|
|
2763
3026
|
/** @description Body for `POST /verifications/sessions/{sessionId}/events`. Status ping only — never carries the proof (use the result endpoint for that). */
|
|
@@ -2801,7 +3064,7 @@ export interface components {
|
|
|
2801
3064
|
/** @description The event that produced this delivery. */
|
|
2802
3065
|
event: components["schemas"]["VerificationEvent"];
|
|
2803
3066
|
timestamp: components["schemas"]["Timestamp"];
|
|
2804
|
-
/** @description Payload interpreted per `event`. Terminal events: the signed result —
|
|
3067
|
+
/** @description Payload interpreted per `event`. Terminal events: the signed result — an **ECIES ciphertext** (base64url, secp256k1 + AES-256-GCM) wrapping the signed JWS when the org's `canEncryptResult` is enabled (decrypt with the matching eth private key to recover the inner JWS), else the JWS directly; the inner JWS parses as the `Jws` schema with payload `VerificationResultPayload`. Non-terminal events: plaintext JSON `{ event, eventData }` (unsigned). */
|
|
2805
3068
|
data: string;
|
|
2806
3069
|
};
|
|
2807
3070
|
/** @description The decoded JWS payload of a delivered verification result (the JWS itself is the `Jws` schema, signed ES256K by the key published at `/.well-known/jwks.json`). Consumers MUST check `reclaimSessionId` against the session they created and `verification_session.status` for the outcome. `results` is present on success; `problem` (RFC 9457 shape) is set when the run failed. */
|
|
@@ -2820,8 +3083,13 @@ export interface components {
|
|
|
2820
3083
|
verification_session: {
|
|
2821
3084
|
/** @enum {string} */
|
|
2822
3085
|
status: "success" | "rejected" | "error";
|
|
2823
|
-
|
|
2824
|
-
|
|
3086
|
+
/** @description The providers verified in this session, in run order. */
|
|
3087
|
+
providers: ({
|
|
3088
|
+
provider_id: components["schemas"]["ProviderID"];
|
|
3089
|
+
resolved_version: string;
|
|
3090
|
+
} & {
|
|
3091
|
+
[key: string]: unknown;
|
|
3092
|
+
})[];
|
|
2825
3093
|
/** Format: uuid */
|
|
2826
3094
|
org_id?: string | null;
|
|
2827
3095
|
/** Format: uuid */
|
|
@@ -2830,19 +3098,26 @@ export interface components {
|
|
|
2830
3098
|
} & {
|
|
2831
3099
|
[key: string]: unknown;
|
|
2832
3100
|
};
|
|
2833
|
-
/** @description One entry per
|
|
3101
|
+
/** @description One entry per verified provider (success only), in run order. Each carries that provider's proven requests. */
|
|
2834
3102
|
results?: ({
|
|
2835
|
-
|
|
2836
|
-
|
|
2837
|
-
|
|
2838
|
-
|
|
3103
|
+
provider_id: components["schemas"]["ProviderID"];
|
|
3104
|
+
resolved_version: string;
|
|
3105
|
+
/** @description One entry per proven request for this provider. */
|
|
3106
|
+
requests: ({
|
|
3107
|
+
request_id?: string;
|
|
3108
|
+
url?: string;
|
|
3109
|
+
method?: string;
|
|
3110
|
+
extracted_parameters?: {
|
|
3111
|
+
[key: string]: unknown;
|
|
3112
|
+
};
|
|
3113
|
+
content_hash?: string;
|
|
3114
|
+
identifier?: string;
|
|
3115
|
+
owner?: string;
|
|
3116
|
+
/** @description Base64url-encoded nested JWS (attestor proof). */
|
|
3117
|
+
proof?: unknown;
|
|
3118
|
+
} & {
|
|
2839
3119
|
[key: string]: unknown;
|
|
2840
|
-
};
|
|
2841
|
-
content_hash?: string;
|
|
2842
|
-
identifier?: string;
|
|
2843
|
-
owner?: string;
|
|
2844
|
-
/** @description Base64url-encoded nested JWS (attestor proof). */
|
|
2845
|
-
proof?: unknown;
|
|
3120
|
+
})[];
|
|
2846
3121
|
} & {
|
|
2847
3122
|
[key: string]: unknown;
|
|
2848
3123
|
})[];
|
|
@@ -2853,18 +3128,18 @@ export interface components {
|
|
|
2853
3128
|
} & {
|
|
2854
3129
|
[key: string]: unknown;
|
|
2855
3130
|
};
|
|
2856
|
-
/** @description A callback subscription's delivery key, returned to the Verification Client. When `publicKeyJwk` is present the VC
|
|
3131
|
+
/** @description A callback subscription's delivery key, returned to the Verification Client. When `publicKeyJwk` is present the VC ECIES-encrypts the result for that org (its `canEncryptResult` is enabled); when absent the VC submits the plaintext signed JWS. */
|
|
2857
3132
|
CallbackKey: {
|
|
2858
3133
|
/** Format: uuid */
|
|
2859
3134
|
subscriptionId: string;
|
|
2860
|
-
/** @description
|
|
2861
|
-
publicKeyJwk?: components["schemas"]["
|
|
3135
|
+
/** @description The org's secp256k1 (eth) public JWK to ECIES-encrypt the result to. Absent ⇒ deliver plaintext. */
|
|
3136
|
+
publicKeyJwk?: components["schemas"]["JwkSecp256k1Public"];
|
|
2862
3137
|
};
|
|
2863
|
-
/** @description One result payload for one callback subscription. The Verification Client signs the JWS and, when the org
|
|
3138
|
+
/** @description One result payload for one callback subscription. The Verification Client signs the JWS and, when the org's `canEncryptResult` is enabled, ECIES-encrypts it to the org's eth public key; otherwise it submits the plaintext JWS. Either way the payload is carried in `payload` and the Builder stores + delivers it as a blind relay. */
|
|
2864
3139
|
CallbackDelivery: {
|
|
2865
3140
|
/** Format: uuid */
|
|
2866
3141
|
subscriptionId: string;
|
|
2867
|
-
/** @description The signed result payload, as raw text
|
|
3142
|
+
/** @description The signed result payload, as raw text — an ECIES ciphertext (base64url) when the org's `canEncryptResult` is enabled, otherwise the plaintext JWS JSON. Same raw form the callback envelope's `data` carries. */
|
|
2868
3143
|
payload: string;
|
|
2869
3144
|
};
|
|
2870
3145
|
/** @description Body for `POST /verifications/sessions/{sessionId}/result`. The Verification Client signs the JWS, encrypts it per callback subscription (keys fetched from the callback-keys endpoint), and submits one ciphertext per subscription. The Builder stores + delivers them; it never sees the plaintext result. */
|
|
@@ -3003,7 +3278,7 @@ export interface operations {
|
|
|
3003
3278
|
Providers: {
|
|
3004
3279
|
parameters: {
|
|
3005
3280
|
query?: {
|
|
3006
|
-
/** @description Free-text search across `title`, `description`, `domain`, `primaryDataPoint`, `dataPoints`, and the latest version's `initialUrl`. Matched case-insensitively; returns results ranked by relevance (e.g., data point matches rank higher than description matches). */
|
|
3281
|
+
/** @description Free-text search across `title`, `description`, `domain`, `primaryDataPoint`, `dataPoints`, and the latest version's `initialUrl`. Matched case-insensitively; returns results ranked by relevance (e.g., data point matches rank higher than description matches). An empty value is treated as no query (the handler redirects to the bare catalog). */
|
|
3007
3282
|
q?: string;
|
|
3008
3283
|
/** @description Filter by tag. Repeat the parameter to OR multiple tags (a provider matching any of them is returned). Combined with `q` via AND. */
|
|
3009
3284
|
tag?: components["schemas"]["Tag"][];
|
|
@@ -3088,6 +3363,263 @@ export interface operations {
|
|
|
3088
3363
|
default: components["responses"]["ProblemResponse"];
|
|
3089
3364
|
};
|
|
3090
3365
|
};
|
|
3366
|
+
DiscoverWebsites: {
|
|
3367
|
+
parameters: {
|
|
3368
|
+
query?: {
|
|
3369
|
+
/** @description Free-text query matched against website domain, data points, brand title, and description. Omit for the popular-websites list. */
|
|
3370
|
+
q?: string;
|
|
3371
|
+
};
|
|
3372
|
+
header?: never;
|
|
3373
|
+
path?: never;
|
|
3374
|
+
cookie?: never;
|
|
3375
|
+
};
|
|
3376
|
+
requestBody?: never;
|
|
3377
|
+
responses: {
|
|
3378
|
+
/** @description Website suggestions. */
|
|
3379
|
+
200: {
|
|
3380
|
+
headers: {
|
|
3381
|
+
[name: string]: unknown;
|
|
3382
|
+
};
|
|
3383
|
+
content: {
|
|
3384
|
+
"application/json": {
|
|
3385
|
+
items: components["schemas"]["WebsiteSuggestion"][];
|
|
3386
|
+
};
|
|
3387
|
+
"text/html": components["schemas"]["HtmlContent"];
|
|
3388
|
+
};
|
|
3389
|
+
};
|
|
3390
|
+
default: components["responses"]["ProblemResponse"];
|
|
3391
|
+
};
|
|
3392
|
+
};
|
|
3393
|
+
SitePage: {
|
|
3394
|
+
parameters: {
|
|
3395
|
+
query?: {
|
|
3396
|
+
/** @description Case-insensitive substring filter on data-point names. Empty = no filter, so clearing the box doesn't need a client workaround. */
|
|
3397
|
+
q?: string;
|
|
3398
|
+
/** @description Currently selected data-point names — from a deep-link (the provider page's "Use provider") or the form's own htmx round-trips. Repeat to pass several; renders the summary panel and pre-checks the boxes. */
|
|
3399
|
+
dataPoints?: string[];
|
|
3400
|
+
/** @description Resolution mode reflected in the Continue URL. */
|
|
3401
|
+
mode?: "list" | "combine";
|
|
3402
|
+
/** @description Source pins from the form: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds (empty = Auto). */
|
|
3403
|
+
pins?: {
|
|
3404
|
+
[key: string]: string;
|
|
3405
|
+
};
|
|
3406
|
+
};
|
|
3407
|
+
header?: never;
|
|
3408
|
+
path: {
|
|
3409
|
+
/** @description Website domain (e.g. `github.com`). Normalized server-side (scheme / `www.` / port / path stripped). */
|
|
3410
|
+
domain: string;
|
|
3411
|
+
};
|
|
3412
|
+
cookie?: never;
|
|
3413
|
+
};
|
|
3414
|
+
requestBody?: never;
|
|
3415
|
+
responses: {
|
|
3416
|
+
/** @description The website's provable data points. */
|
|
3417
|
+
200: {
|
|
3418
|
+
headers: {
|
|
3419
|
+
[name: string]: unknown;
|
|
3420
|
+
};
|
|
3421
|
+
content: {
|
|
3422
|
+
"application/json": {
|
|
3423
|
+
/** Format: hostname */
|
|
3424
|
+
domain: string;
|
|
3425
|
+
brandName: string;
|
|
3426
|
+
/** Format: uri */
|
|
3427
|
+
iconUrl?: string;
|
|
3428
|
+
dataPoints: components["schemas"]["DataPointItem"][];
|
|
3429
|
+
};
|
|
3430
|
+
"text/html": components["schemas"]["HtmlContent"];
|
|
3431
|
+
};
|
|
3432
|
+
};
|
|
3433
|
+
404: components["responses"]["ProblemResponse"];
|
|
3434
|
+
default: components["responses"]["ProblemResponse"];
|
|
3435
|
+
};
|
|
3436
|
+
};
|
|
3437
|
+
SitePanel: {
|
|
3438
|
+
parameters: {
|
|
3439
|
+
query?: {
|
|
3440
|
+
/** @description Selected data-point names. Repeat to pass several. */
|
|
3441
|
+
dataPoints?: string[];
|
|
3442
|
+
/** @description Resolution mode reflected in the Continue URL. */
|
|
3443
|
+
mode?: "list" | "combine";
|
|
3444
|
+
/** @description Source pins from the form: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds (empty = Auto). */
|
|
3445
|
+
pins?: {
|
|
3446
|
+
[key: string]: string;
|
|
3447
|
+
};
|
|
3448
|
+
/** @description The data-point filter input rides along in the form submit; accepted and ignored here (the panel doesn't filter). */
|
|
3449
|
+
q?: string;
|
|
3450
|
+
};
|
|
3451
|
+
header?: never;
|
|
3452
|
+
path: {
|
|
3453
|
+
/** @description Website domain (normalized server-side). */
|
|
3454
|
+
domain: string;
|
|
3455
|
+
};
|
|
3456
|
+
cookie?: never;
|
|
3457
|
+
};
|
|
3458
|
+
requestBody?: never;
|
|
3459
|
+
responses: {
|
|
3460
|
+
/** @description The summary-panel fragment. */
|
|
3461
|
+
200: {
|
|
3462
|
+
headers: {
|
|
3463
|
+
[name: string]: unknown;
|
|
3464
|
+
};
|
|
3465
|
+
content: {
|
|
3466
|
+
"text/html": components["schemas"]["HtmlContent"];
|
|
3467
|
+
};
|
|
3468
|
+
};
|
|
3469
|
+
404: components["responses"]["ProblemResponse"];
|
|
3470
|
+
default: components["responses"]["ProblemResponse"];
|
|
3471
|
+
};
|
|
3472
|
+
};
|
|
3473
|
+
SiteBuild: {
|
|
3474
|
+
parameters: {
|
|
3475
|
+
query: {
|
|
3476
|
+
/** @description Selected data-point names. Repeat to pass several. */
|
|
3477
|
+
dataPoints: string[];
|
|
3478
|
+
/** @description `combine` (default) minimizes to the fewest providers (set-cover); `list` uses one provider per data point. */
|
|
3479
|
+
mode?: "list" | "combine";
|
|
3480
|
+
/** @description Source pins: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds. Omit for Auto. */
|
|
3481
|
+
pins?: {
|
|
3482
|
+
[key: string]: string;
|
|
3483
|
+
};
|
|
3484
|
+
/** @description Data-point names the consumer opts to SUPPLY themselves (as verification `context`) instead of having a provider prove — shrinks the provider set. Repeat to pass several. Only names that are a provider input are honoured. Subset of `dataPoints`. */
|
|
3485
|
+
provided?: string[];
|
|
3486
|
+
};
|
|
3487
|
+
header?: never;
|
|
3488
|
+
path: {
|
|
3489
|
+
/** @description Website domain (normalized server-side). */
|
|
3490
|
+
domain: string;
|
|
3491
|
+
};
|
|
3492
|
+
cookie?: never;
|
|
3493
|
+
};
|
|
3494
|
+
requestBody?: never;
|
|
3495
|
+
responses: {
|
|
3496
|
+
/** @description The build page. */
|
|
3497
|
+
200: {
|
|
3498
|
+
headers: {
|
|
3499
|
+
[name: string]: unknown;
|
|
3500
|
+
};
|
|
3501
|
+
content: {
|
|
3502
|
+
"text/html": components["schemas"]["HtmlContent"];
|
|
3503
|
+
};
|
|
3504
|
+
};
|
|
3505
|
+
404: components["responses"]["ProblemResponse"];
|
|
3506
|
+
default: components["responses"]["ProblemResponse"];
|
|
3507
|
+
};
|
|
3508
|
+
};
|
|
3509
|
+
SiteBuildTry: {
|
|
3510
|
+
parameters: {
|
|
3511
|
+
query: {
|
|
3512
|
+
/** @description Selected data-point names. Repeat to pass several. */
|
|
3513
|
+
dataPoints: string[];
|
|
3514
|
+
/** @description Resolution mode (`combine` default | `list`). */
|
|
3515
|
+
mode?: "list" | "combine";
|
|
3516
|
+
/** @description Source pins: `pins[<dataPoint>]=id,id`. Maps each data-point name to a comma-joined list of preferred providerIds. */
|
|
3517
|
+
pins?: {
|
|
3518
|
+
[key: string]: string;
|
|
3519
|
+
};
|
|
3520
|
+
/** @description Data-point names the consumer supplies themselves (as `context`) instead of proving. Repeat to pass several. Subset of `dataPoints`. */
|
|
3521
|
+
provided?: string[];
|
|
3522
|
+
};
|
|
3523
|
+
header?: never;
|
|
3524
|
+
path: {
|
|
3525
|
+
/** @description Website domain (normalized server-side). */
|
|
3526
|
+
domain: string;
|
|
3527
|
+
};
|
|
3528
|
+
cookie?: never;
|
|
3529
|
+
};
|
|
3530
|
+
/** @description The verification `context` — values for the resolved providers' requiredContext inputs (the build page's input fields). The selection itself travels in the query string. */
|
|
3531
|
+
requestBody?: {
|
|
3532
|
+
content: {
|
|
3533
|
+
"application/x-www-form-urlencoded": components["schemas"]["SiteBuildTryBody"];
|
|
3534
|
+
"application/json": components["schemas"]["SiteBuildTryBody"];
|
|
3535
|
+
};
|
|
3536
|
+
};
|
|
3537
|
+
responses: {
|
|
3538
|
+
/** @description Session created. */
|
|
3539
|
+
201: {
|
|
3540
|
+
headers: {
|
|
3541
|
+
[name: string]: unknown;
|
|
3542
|
+
};
|
|
3543
|
+
content: {
|
|
3544
|
+
"application/json": components["schemas"]["VerificationSession"];
|
|
3545
|
+
};
|
|
3546
|
+
};
|
|
3547
|
+
401: components["responses"]["ProblemResponse"];
|
|
3548
|
+
/** @description One or more selected data points are not covered by any provider. */
|
|
3549
|
+
422: {
|
|
3550
|
+
headers: {
|
|
3551
|
+
[name: string]: unknown;
|
|
3552
|
+
};
|
|
3553
|
+
content: {
|
|
3554
|
+
"application/problem+json": components["schemas"]["Problem"];
|
|
3555
|
+
};
|
|
3556
|
+
};
|
|
3557
|
+
/** @description Sandbox verification quota exceeded. */
|
|
3558
|
+
429: {
|
|
3559
|
+
headers: {
|
|
3560
|
+
[name: string]: unknown;
|
|
3561
|
+
};
|
|
3562
|
+
content: {
|
|
3563
|
+
"application/problem+json": components["schemas"]["Problem"];
|
|
3564
|
+
};
|
|
3565
|
+
};
|
|
3566
|
+
default: components["responses"]["ProblemResponse"];
|
|
3567
|
+
};
|
|
3568
|
+
};
|
|
3569
|
+
DiscoverTeachAgent: {
|
|
3570
|
+
parameters: {
|
|
3571
|
+
query?: {
|
|
3572
|
+
/** @description Website the user wanted to verify data from. */
|
|
3573
|
+
domain?: string;
|
|
3574
|
+
/** @description Specific data point the user could not find. */
|
|
3575
|
+
dataPoint?: string;
|
|
3576
|
+
};
|
|
3577
|
+
header?: never;
|
|
3578
|
+
path?: never;
|
|
3579
|
+
cookie?: never;
|
|
3580
|
+
};
|
|
3581
|
+
requestBody?: never;
|
|
3582
|
+
responses: {
|
|
3583
|
+
200: components["responses"]["HTMLResponse"];
|
|
3584
|
+
default: components["responses"]["ProblemResponse"];
|
|
3585
|
+
};
|
|
3586
|
+
};
|
|
3587
|
+
DiscoverResolve: {
|
|
3588
|
+
parameters: {
|
|
3589
|
+
query: {
|
|
3590
|
+
/** @description Website domain (normalized server-side). */
|
|
3591
|
+
domain: string;
|
|
3592
|
+
/** @description Selected data-point names. Repeat to pass several. */
|
|
3593
|
+
dataPoints: string[];
|
|
3594
|
+
};
|
|
3595
|
+
header?: never;
|
|
3596
|
+
path?: never;
|
|
3597
|
+
cookie?: never;
|
|
3598
|
+
};
|
|
3599
|
+
requestBody?: never;
|
|
3600
|
+
responses: {
|
|
3601
|
+
/** @description Covering providers (possibly none). */
|
|
3602
|
+
200: {
|
|
3603
|
+
headers: {
|
|
3604
|
+
[name: string]: unknown;
|
|
3605
|
+
};
|
|
3606
|
+
content: {
|
|
3607
|
+
"application/json": {
|
|
3608
|
+
/** @description The most specific covering provider's id, if any — a convenience for the common single-provider case. */
|
|
3609
|
+
providerId?: components["schemas"]["ProviderID"];
|
|
3610
|
+
/** @description True when no existing provider covers the full selection (a new one must be created/stitched). */
|
|
3611
|
+
needsCreation: boolean;
|
|
3612
|
+
providers: {
|
|
3613
|
+
providerId: components["schemas"]["ProviderID"];
|
|
3614
|
+
slug: string;
|
|
3615
|
+
dataPoints: string[];
|
|
3616
|
+
}[];
|
|
3617
|
+
};
|
|
3618
|
+
};
|
|
3619
|
+
};
|
|
3620
|
+
default: components["responses"]["ProblemResponse"];
|
|
3621
|
+
};
|
|
3622
|
+
};
|
|
3091
3623
|
ProviderPreviewImage: {
|
|
3092
3624
|
parameters: {
|
|
3093
3625
|
query?: {
|
|
@@ -3475,6 +4007,27 @@ export interface operations {
|
|
|
3475
4007
|
default: components["responses"]["ProblemResponse"];
|
|
3476
4008
|
};
|
|
3477
4009
|
};
|
|
4010
|
+
DisposeVerificationSession: {
|
|
4011
|
+
parameters: {
|
|
4012
|
+
query?: never;
|
|
4013
|
+
header?: never;
|
|
4014
|
+
path: {
|
|
4015
|
+
sessionId: components["schemas"]["SessionID"];
|
|
4016
|
+
};
|
|
4017
|
+
cookie?: never;
|
|
4018
|
+
};
|
|
4019
|
+
requestBody?: never;
|
|
4020
|
+
responses: {
|
|
4021
|
+
/** @description Dispose requested. */
|
|
4022
|
+
204: {
|
|
4023
|
+
headers: {
|
|
4024
|
+
[name: string]: unknown;
|
|
4025
|
+
};
|
|
4026
|
+
content?: never;
|
|
4027
|
+
};
|
|
4028
|
+
default: components["responses"]["ProblemResponse"];
|
|
4029
|
+
};
|
|
4030
|
+
};
|
|
3478
4031
|
VerificationSessionSse: {
|
|
3479
4032
|
parameters: {
|
|
3480
4033
|
query?: never;
|
|
@@ -3655,31 +4208,6 @@ export interface operations {
|
|
|
3655
4208
|
default: components["responses"]["ProblemResponse"];
|
|
3656
4209
|
};
|
|
3657
4210
|
};
|
|
3658
|
-
UpdateMe: {
|
|
3659
|
-
parameters: {
|
|
3660
|
-
query?: never;
|
|
3661
|
-
header?: never;
|
|
3662
|
-
path?: never;
|
|
3663
|
-
cookie?: never;
|
|
3664
|
-
};
|
|
3665
|
-
requestBody: {
|
|
3666
|
-
content: {
|
|
3667
|
-
"application/json": components["schemas"]["UpdateUserRequest"];
|
|
3668
|
-
};
|
|
3669
|
-
};
|
|
3670
|
-
responses: {
|
|
3671
|
-
/** @description Updated */
|
|
3672
|
-
200: {
|
|
3673
|
-
headers: {
|
|
3674
|
-
[name: string]: unknown;
|
|
3675
|
-
};
|
|
3676
|
-
content: {
|
|
3677
|
-
"application/json": components["schemas"]["User"];
|
|
3678
|
-
};
|
|
3679
|
-
};
|
|
3680
|
-
default: components["responses"]["ProblemResponse"];
|
|
3681
|
-
};
|
|
3682
|
-
};
|
|
3683
4211
|
GetUser: {
|
|
3684
4212
|
parameters: {
|
|
3685
4213
|
query?: never;
|
|
@@ -3759,7 +4287,10 @@ export interface operations {
|
|
|
3759
4287
|
};
|
|
3760
4288
|
GetOrg: {
|
|
3761
4289
|
parameters: {
|
|
3762
|
-
query?:
|
|
4290
|
+
query?: {
|
|
4291
|
+
/** @description Which section to show (server-rendered tab); unknown values fall back to the first. */
|
|
4292
|
+
tab?: "connect" | "providers" | "members" | "themes" | "sessions" | "billing";
|
|
4293
|
+
};
|
|
3763
4294
|
header?: never;
|
|
3764
4295
|
path: {
|
|
3765
4296
|
orgId: components["schemas"]["OrgID"];
|
|
@@ -3832,6 +4363,32 @@ export interface operations {
|
|
|
3832
4363
|
default: components["responses"]["ProblemResponse"];
|
|
3833
4364
|
};
|
|
3834
4365
|
};
|
|
4366
|
+
SearchOrgMembers: {
|
|
4367
|
+
parameters: {
|
|
4368
|
+
query?: {
|
|
4369
|
+
/** @description Case-insensitive email substring to filter by. */
|
|
4370
|
+
q?: string;
|
|
4371
|
+
};
|
|
4372
|
+
header?: never;
|
|
4373
|
+
path: {
|
|
4374
|
+
orgId: components["schemas"]["OrgID"];
|
|
4375
|
+
};
|
|
4376
|
+
cookie?: never;
|
|
4377
|
+
};
|
|
4378
|
+
requestBody?: never;
|
|
4379
|
+
responses: {
|
|
4380
|
+
/** @description The members-list fragment. */
|
|
4381
|
+
200: {
|
|
4382
|
+
headers: {
|
|
4383
|
+
[name: string]: unknown;
|
|
4384
|
+
};
|
|
4385
|
+
content: {
|
|
4386
|
+
"text/html": components["schemas"]["HtmlContent"];
|
|
4387
|
+
};
|
|
4388
|
+
};
|
|
4389
|
+
default: components["responses"]["ProblemResponse"];
|
|
4390
|
+
};
|
|
4391
|
+
};
|
|
3835
4392
|
AddOrgMember: {
|
|
3836
4393
|
parameters: {
|
|
3837
4394
|
query?: never;
|
|
@@ -4105,7 +4662,7 @@ export interface operations {
|
|
|
4105
4662
|
default: components["responses"]["ProblemResponse"];
|
|
4106
4663
|
};
|
|
4107
4664
|
};
|
|
4108
|
-
|
|
4665
|
+
GetOrgKeypair: {
|
|
4109
4666
|
parameters: {
|
|
4110
4667
|
query?: never;
|
|
4111
4668
|
header?: never;
|
|
@@ -4122,7 +4679,7 @@ export interface operations {
|
|
|
4122
4679
|
[name: string]: unknown;
|
|
4123
4680
|
};
|
|
4124
4681
|
content: {
|
|
4125
|
-
"application/json": components["schemas"]["
|
|
4682
|
+
"application/json": components["schemas"]["OrgKeypair"];
|
|
4126
4683
|
};
|
|
4127
4684
|
};
|
|
4128
4685
|
403: components["responses"]["ForbiddenResponse"];
|
|
@@ -4130,7 +4687,7 @@ export interface operations {
|
|
|
4130
4687
|
default: components["responses"]["ProblemResponse"];
|
|
4131
4688
|
};
|
|
4132
4689
|
};
|
|
4133
|
-
|
|
4690
|
+
SetOrgKeypair: {
|
|
4134
4691
|
parameters: {
|
|
4135
4692
|
query?: never;
|
|
4136
4693
|
header?: never;
|
|
@@ -4141,7 +4698,7 @@ export interface operations {
|
|
|
4141
4698
|
};
|
|
4142
4699
|
requestBody: {
|
|
4143
4700
|
content: {
|
|
4144
|
-
"application/json": components["schemas"]["
|
|
4701
|
+
"application/json": components["schemas"]["OrgKeypairRequest"];
|
|
4145
4702
|
};
|
|
4146
4703
|
};
|
|
4147
4704
|
responses: {
|
|
@@ -4151,7 +4708,7 @@ export interface operations {
|
|
|
4151
4708
|
[name: string]: unknown;
|
|
4152
4709
|
};
|
|
4153
4710
|
content: {
|
|
4154
|
-
"application/json": components["schemas"]["
|
|
4711
|
+
"application/json": components["schemas"]["OrgKeypair"];
|
|
4155
4712
|
};
|
|
4156
4713
|
};
|
|
4157
4714
|
400: components["responses"]["ProblemResponse"];
|
|
@@ -4159,7 +4716,7 @@ export interface operations {
|
|
|
4159
4716
|
default: components["responses"]["ProblemResponse"];
|
|
4160
4717
|
};
|
|
4161
4718
|
};
|
|
4162
|
-
|
|
4719
|
+
DeleteOrgKeypair: {
|
|
4163
4720
|
parameters: {
|
|
4164
4721
|
query?: never;
|
|
4165
4722
|
header?: never;
|
|
@@ -4380,6 +4937,29 @@ export interface operations {
|
|
|
4380
4937
|
default: components["responses"]["ProblemResponse"];
|
|
4381
4938
|
};
|
|
4382
4939
|
};
|
|
4940
|
+
AttachLanding: {
|
|
4941
|
+
parameters: {
|
|
4942
|
+
query?: {
|
|
4943
|
+
/** @description A submitted pairing code; redirects to `/attach/{code}`. */
|
|
4944
|
+
code?: string;
|
|
4945
|
+
};
|
|
4946
|
+
header?: never;
|
|
4947
|
+
path?: never;
|
|
4948
|
+
cookie?: never;
|
|
4949
|
+
};
|
|
4950
|
+
requestBody?: never;
|
|
4951
|
+
responses: {
|
|
4952
|
+
200: components["responses"]["HTMLResponse"];
|
|
4953
|
+
/** @description Redirect to the canonical `/attach/{code}` URL. */
|
|
4954
|
+
302: {
|
|
4955
|
+
headers: {
|
|
4956
|
+
[name: string]: unknown;
|
|
4957
|
+
};
|
|
4958
|
+
content?: never;
|
|
4959
|
+
};
|
|
4960
|
+
default: components["responses"]["ProblemResponse"];
|
|
4961
|
+
};
|
|
4962
|
+
};
|
|
4383
4963
|
AttachPage: {
|
|
4384
4964
|
parameters: {
|
|
4385
4965
|
query?: never;
|
|
@@ -5237,9 +5817,18 @@ export interface operations {
|
|
|
5237
5817
|
};
|
|
5238
5818
|
content: {
|
|
5239
5819
|
"application/json": {
|
|
5240
|
-
|
|
5241
|
-
|
|
5242
|
-
|
|
5820
|
+
/** @description One recipe per session provider, in run order. */
|
|
5821
|
+
recipes: {
|
|
5822
|
+
providerId: components["schemas"]["ProviderID"];
|
|
5823
|
+
resolvedVersion: string;
|
|
5824
|
+
initialUrl: string;
|
|
5825
|
+
/** @description The version's webSettings geoLocation template (`{{DYNAMIC_GEO}}` / '' / ISO code), applied to this provider's requests. */
|
|
5826
|
+
geoLocation?: string;
|
|
5827
|
+
/** @description The version's webSettings.jsUserScripts — page JavaScript the Verification Client installs to run before every page load (before navigating to initialUrl), to drive login/navigation so the target requests fire. */
|
|
5828
|
+
jsUserScripts?: string;
|
|
5829
|
+
requests: {
|
|
5830
|
+
[key: string]: unknown;
|
|
5831
|
+
}[];
|
|
5243
5832
|
}[];
|
|
5244
5833
|
};
|
|
5245
5834
|
};
|
|
@@ -5383,7 +5972,7 @@ export interface operations {
|
|
|
5383
5972
|
/** Format: uuid */
|
|
5384
5973
|
subscriptionId: string;
|
|
5385
5974
|
event: components["schemas"]["VerificationEvent"];
|
|
5386
|
-
/** @description The result payload, as raw text
|
|
5975
|
+
/** @description The result payload, as raw text: an ECIES ciphertext (base64url) wrapping the signed result JWS when the org's `canEncryptResult` is enabled, else the plaintext signed JWS JSON. */
|
|
5387
5976
|
payload: string;
|
|
5388
5977
|
deliveryStatus: components["schemas"]["CallbackDeliveryStatus"];
|
|
5389
5978
|
createdAt: components["schemas"]["Timestamp"];
|