@relentless-identity/sdk 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,1265 @@
1
+ /**
2
+ * Alias information when email is resolved to a different address.
3
+ * @export
4
+ * @interface AliasInfo
5
+ */
6
+ export interface AliasInfo {
7
+ /**
8
+ *
9
+ * @type {string}
10
+ * @memberof AliasInfo
11
+ */
12
+ original?: string | null;
13
+ /**
14
+ *
15
+ * @type {string}
16
+ * @memberof AliasInfo
17
+ */
18
+ resolved?: string | null;
19
+ }
20
+ /**
21
+ *
22
+ * @export
23
+ * @interface BatchSummary
24
+ */
25
+ export interface BatchSummary {
26
+ /**
27
+ * Total number of requested items.
28
+ * @type {number}
29
+ * @memberof BatchSummary
30
+ */
31
+ total: number;
32
+ /**
33
+ * Items that resolved to a positive deliverable result.
34
+ * @type {number}
35
+ * @memberof BatchSummary
36
+ */
37
+ found: number;
38
+ /**
39
+ * Items that completed cleanly with a negative result.
40
+ * @type {number}
41
+ * @memberof BatchSummary
42
+ */
43
+ notFound: number;
44
+ /**
45
+ * Items that ended with an operational verification error rather than a mailbox verdict.
46
+ * @type {number}
47
+ * @memberof BatchSummary
48
+ */
49
+ errors: number;
50
+ /**
51
+ * Distinct mailbox domains represented in the batch.
52
+ * @type {number}
53
+ * @memberof BatchSummary
54
+ */
55
+ uniqueDomains: number;
56
+ }
57
+ /**
58
+ * Background job detail plus paginated item results.
59
+ * @export
60
+ * @interface ClientBackgroundJobDetailResponse
61
+ */
62
+ export interface ClientBackgroundJobDetailResponse {
63
+ /**
64
+ *
65
+ * @type {ClientBackgroundJobResponse}
66
+ * @memberof ClientBackgroundJobDetailResponse
67
+ */
68
+ job: ClientBackgroundJobResponse;
69
+ /**
70
+ *
71
+ * @type {Array<ClientBackgroundJobItemResponse>}
72
+ * @memberof ClientBackgroundJobDetailResponse
73
+ */
74
+ items: Array<ClientBackgroundJobItemResponse>;
75
+ /**
76
+ *
77
+ * @type {number}
78
+ * @memberof ClientBackgroundJobDetailResponse
79
+ */
80
+ totalItems: number;
81
+ /**
82
+ *
83
+ * @type {number}
84
+ * @memberof ClientBackgroundJobDetailResponse
85
+ */
86
+ page: number;
87
+ /**
88
+ *
89
+ * @type {number}
90
+ * @memberof ClientBackgroundJobDetailResponse
91
+ */
92
+ pageSize: number;
93
+ /**
94
+ *
95
+ * @type {number}
96
+ * @memberof ClientBackgroundJobDetailResponse
97
+ */
98
+ totalPages: number;
99
+ /**
100
+ * Whether the stored item payload rows have already expired and been pruned.
101
+ * @type {boolean}
102
+ * @memberof ClientBackgroundJobDetailResponse
103
+ */
104
+ resultsExpired?: boolean;
105
+ }
106
+ /**
107
+ * One item inside a background job payload.
108
+ * @export
109
+ * @interface ClientBackgroundJobItemResponse
110
+ */
111
+ export interface ClientBackgroundJobItemResponse {
112
+ /**
113
+ *
114
+ * @type {string}
115
+ * @memberof ClientBackgroundJobItemResponse
116
+ */
117
+ id: string;
118
+ /**
119
+ *
120
+ * @type {number}
121
+ * @memberof ClientBackgroundJobItemResponse
122
+ */
123
+ itemIndex: number;
124
+ /**
125
+ *
126
+ * @type {ClientBackgroundJobItemResponseStatusEnum}
127
+ * @memberof ClientBackgroundJobItemResponse
128
+ */
129
+ status: ClientBackgroundJobItemResponseStatusEnum;
130
+ /**
131
+ *
132
+ * @type {ClientBackgroundJobItemResponseRequestTypeEnum}
133
+ * @memberof ClientBackgroundJobItemResponse
134
+ */
135
+ requestType: ClientBackgroundJobItemResponseRequestTypeEnum;
136
+ /**
137
+ * Original submitted input for this item.
138
+ * @type {{ [key: string]: any; }}
139
+ * @memberof ClientBackgroundJobItemResponse
140
+ */
141
+ input: {
142
+ [key: string]: any;
143
+ };
144
+ /**
145
+ *
146
+ * @type {{ [key: string]: any; }}
147
+ * @memberof ClientBackgroundJobItemResponse
148
+ */
149
+ result?: {
150
+ [key: string]: any;
151
+ } | null;
152
+ /**
153
+ *
154
+ * @type {string}
155
+ * @memberof ClientBackgroundJobItemResponse
156
+ */
157
+ resultState?: string | null;
158
+ /**
159
+ *
160
+ * @type {ClientBackgroundJobItemResponseResultOutcomeEnum}
161
+ * @memberof ClientBackgroundJobItemResponse
162
+ */
163
+ resultOutcome?: ClientBackgroundJobItemResponseResultOutcomeEnum | null;
164
+ /**
165
+ *
166
+ * @type {string}
167
+ * @memberof ClientBackgroundJobItemResponse
168
+ */
169
+ resolvedAddress?: string | null;
170
+ /**
171
+ *
172
+ * @type {string}
173
+ * @memberof ClientBackgroundJobItemResponse
174
+ */
175
+ provider?: string | null;
176
+ /**
177
+ *
178
+ * @type {number}
179
+ * @memberof ClientBackgroundJobItemResponse
180
+ */
181
+ chargeMicros?: number;
182
+ /**
183
+ *
184
+ * @type {string}
185
+ * @memberof ClientBackgroundJobItemResponse
186
+ */
187
+ errorMessage?: string | null;
188
+ /**
189
+ *
190
+ * @type {string}
191
+ * @memberof ClientBackgroundJobItemResponse
192
+ */
193
+ startedAt?: string | null;
194
+ /**
195
+ *
196
+ * @type {string}
197
+ * @memberof ClientBackgroundJobItemResponse
198
+ */
199
+ completedAt?: string | null;
200
+ /**
201
+ *
202
+ * @type {string}
203
+ * @memberof ClientBackgroundJobItemResponse
204
+ */
205
+ createdAt: string;
206
+ /**
207
+ *
208
+ * @type {string}
209
+ * @memberof ClientBackgroundJobItemResponse
210
+ */
211
+ updatedAt: string;
212
+ }
213
+ /**
214
+ * @export
215
+ */
216
+ export declare const ClientBackgroundJobItemResponseStatusEnum: {
217
+ readonly Queued: "queued";
218
+ readonly Processing: "processing";
219
+ readonly Completed: "completed";
220
+ readonly Error: "error";
221
+ readonly Canceled: "canceled";
222
+ };
223
+ export type ClientBackgroundJobItemResponseStatusEnum = typeof ClientBackgroundJobItemResponseStatusEnum[keyof typeof ClientBackgroundJobItemResponseStatusEnum];
224
+ /**
225
+ * @export
226
+ */
227
+ export declare const ClientBackgroundJobItemResponseRequestTypeEnum: {
228
+ readonly Finder: "finder";
229
+ readonly Probe: "probe";
230
+ };
231
+ export type ClientBackgroundJobItemResponseRequestTypeEnum = typeof ClientBackgroundJobItemResponseRequestTypeEnum[keyof typeof ClientBackgroundJobItemResponseRequestTypeEnum];
232
+ /**
233
+ * @export
234
+ */
235
+ export declare const ClientBackgroundJobItemResponseResultOutcomeEnum: {
236
+ readonly Found: "found";
237
+ readonly NotFound: "not_found";
238
+ readonly Error: "error";
239
+ };
240
+ export type ClientBackgroundJobItemResponseResultOutcomeEnum = typeof ClientBackgroundJobItemResponseResultOutcomeEnum[keyof typeof ClientBackgroundJobItemResponseResultOutcomeEnum];
241
+ /**
242
+ * Paginated list of background jobs for the authenticated user.
243
+ * @export
244
+ * @interface ClientBackgroundJobPageResponse
245
+ */
246
+ export interface ClientBackgroundJobPageResponse {
247
+ /**
248
+ *
249
+ * @type {Array<ClientBackgroundJobResponse>}
250
+ * @memberof ClientBackgroundJobPageResponse
251
+ */
252
+ items: Array<ClientBackgroundJobResponse>;
253
+ /**
254
+ *
255
+ * @type {number}
256
+ * @memberof ClientBackgroundJobPageResponse
257
+ */
258
+ total: number;
259
+ /**
260
+ *
261
+ * @type {number}
262
+ * @memberof ClientBackgroundJobPageResponse
263
+ */
264
+ page: number;
265
+ /**
266
+ *
267
+ * @type {number}
268
+ * @memberof ClientBackgroundJobPageResponse
269
+ */
270
+ pageSize: number;
271
+ /**
272
+ *
273
+ * @type {number}
274
+ * @memberof ClientBackgroundJobPageResponse
275
+ */
276
+ totalPages: number;
277
+ }
278
+ /**
279
+ * Background job status envelope returned by the public jobs API.
280
+ * @export
281
+ * @interface ClientBackgroundJobResponse
282
+ */
283
+ export interface ClientBackgroundJobResponse {
284
+ /**
285
+ *
286
+ * @type {string}
287
+ * @memberof ClientBackgroundJobResponse
288
+ */
289
+ id: string;
290
+ /**
291
+ *
292
+ * @type {ClientBackgroundJobResponseJobTypeEnum}
293
+ * @memberof ClientBackgroundJobResponse
294
+ */
295
+ jobType: ClientBackgroundJobResponseJobTypeEnum;
296
+ /**
297
+ * Current high-level job lifecycle state.
298
+ * @type {ClientBackgroundJobResponseStatusEnum}
299
+ * @memberof ClientBackgroundJobResponse
300
+ */
301
+ status: ClientBackgroundJobResponseStatusEnum;
302
+ /**
303
+ *
304
+ * @type {string}
305
+ * @memberof ClientBackgroundJobResponse
306
+ */
307
+ deadlineAt: string;
308
+ /**
309
+ *
310
+ * @type {number}
311
+ * @memberof ClientBackgroundJobResponse
312
+ */
313
+ estimatedRuntimeSeconds: number;
314
+ /**
315
+ *
316
+ * @type {string}
317
+ * @memberof ClientBackgroundJobResponse
318
+ */
319
+ scheduledStartAt: string;
320
+ /**
321
+ *
322
+ * @type {string}
323
+ * @memberof ClientBackgroundJobResponse
324
+ */
325
+ callbackUrl?: string | null;
326
+ /**
327
+ *
328
+ * @type {ClientBackgroundJobResponseCallbackStatusEnum}
329
+ * @memberof ClientBackgroundJobResponse
330
+ */
331
+ callbackStatus: ClientBackgroundJobResponseCallbackStatusEnum;
332
+ /**
333
+ *
334
+ * @type {number}
335
+ * @memberof ClientBackgroundJobResponse
336
+ */
337
+ callbackAttempts: number;
338
+ /**
339
+ *
340
+ * @type {string}
341
+ * @memberof ClientBackgroundJobResponse
342
+ */
343
+ callbackLastError?: string | null;
344
+ /**
345
+ * Total number of submitted items for the job.
346
+ * @type {number}
347
+ * @memberof ClientBackgroundJobResponse
348
+ */
349
+ requestedCount: number;
350
+ /**
351
+ *
352
+ * @type {number}
353
+ * @memberof ClientBackgroundJobResponse
354
+ */
355
+ completedCount: number;
356
+ /**
357
+ *
358
+ * @type {number}
359
+ * @memberof ClientBackgroundJobResponse
360
+ */
361
+ successCount: number;
362
+ /**
363
+ *
364
+ * @type {number}
365
+ * @memberof ClientBackgroundJobResponse
366
+ */
367
+ notFoundCount: number;
368
+ /**
369
+ *
370
+ * @type {number}
371
+ * @memberof ClientBackgroundJobResponse
372
+ */
373
+ errorCount: number;
374
+ /**
375
+ *
376
+ * @type {number}
377
+ * @memberof ClientBackgroundJobResponse
378
+ */
379
+ reservedAmountMicros: number;
380
+ /**
381
+ *
382
+ * @type {number}
383
+ * @memberof ClientBackgroundJobResponse
384
+ */
385
+ actualAmountMicros: number;
386
+ /**
387
+ * Approximate percent complete based on completed item count.
388
+ * @type {number}
389
+ * @memberof ClientBackgroundJobResponse
390
+ */
391
+ progressPercent?: number;
392
+ /**
393
+ * Aggregated counts and provider stats for the job.
394
+ * @type {{ [key: string]: any; }}
395
+ * @memberof ClientBackgroundJobResponse
396
+ */
397
+ summary?: {
398
+ [key: string]: any;
399
+ };
400
+ /**
401
+ *
402
+ * @type {{ [key: string]: any; }}
403
+ * @memberof ClientBackgroundJobResponse
404
+ */
405
+ metadata?: {
406
+ [key: string]: any;
407
+ };
408
+ /**
409
+ *
410
+ * @type {string}
411
+ * @memberof ClientBackgroundJobResponse
412
+ */
413
+ startedAt?: string | null;
414
+ /**
415
+ *
416
+ * @type {string}
417
+ * @memberof ClientBackgroundJobResponse
418
+ */
419
+ completedAt?: string | null;
420
+ /**
421
+ *
422
+ * @type {string}
423
+ * @memberof ClientBackgroundJobResponse
424
+ */
425
+ historyExpiresAt?: string | null;
426
+ /**
427
+ *
428
+ * @type {string}
429
+ * @memberof ClientBackgroundJobResponse
430
+ */
431
+ resultsPrunedAt?: string | null;
432
+ /**
433
+ *
434
+ * @type {boolean}
435
+ * @memberof ClientBackgroundJobResponse
436
+ */
437
+ artifactAvailable?: boolean;
438
+ /**
439
+ *
440
+ * @type {string}
441
+ * @memberof ClientBackgroundJobResponse
442
+ */
443
+ artifactJsonUrl?: string | null;
444
+ /**
445
+ *
446
+ * @type {number}
447
+ * @memberof ClientBackgroundJobResponse
448
+ */
449
+ artifactSizeBytes?: number | null;
450
+ /**
451
+ *
452
+ * @type {string}
453
+ * @memberof ClientBackgroundJobResponse
454
+ */
455
+ artifactUploadedAt?: string | null;
456
+ /**
457
+ *
458
+ * @type {string}
459
+ * @memberof ClientBackgroundJobResponse
460
+ */
461
+ createdAt: string;
462
+ /**
463
+ *
464
+ * @type {string}
465
+ * @memberof ClientBackgroundJobResponse
466
+ */
467
+ updatedAt: string;
468
+ }
469
+ /**
470
+ * @export
471
+ */
472
+ export declare const ClientBackgroundJobResponseJobTypeEnum: {
473
+ readonly FinderBatch: "finder_batch";
474
+ readonly ProbeBatch: "probe_batch";
475
+ };
476
+ export type ClientBackgroundJobResponseJobTypeEnum = typeof ClientBackgroundJobResponseJobTypeEnum[keyof typeof ClientBackgroundJobResponseJobTypeEnum];
477
+ /**
478
+ * @export
479
+ */
480
+ export declare const ClientBackgroundJobResponseStatusEnum: {
481
+ readonly Queued: "queued";
482
+ readonly Processing: "processing";
483
+ readonly Completed: "completed";
484
+ readonly Failed: "failed";
485
+ readonly Canceled: "canceled";
486
+ };
487
+ export type ClientBackgroundJobResponseStatusEnum = typeof ClientBackgroundJobResponseStatusEnum[keyof typeof ClientBackgroundJobResponseStatusEnum];
488
+ /**
489
+ * @export
490
+ */
491
+ export declare const ClientBackgroundJobResponseCallbackStatusEnum: {
492
+ readonly None: "none";
493
+ readonly Pending: "pending";
494
+ readonly Delivered: "delivered";
495
+ readonly Failed: "failed";
496
+ };
497
+ export type ClientBackgroundJobResponseCallbackStatusEnum = typeof ClientBackgroundJobResponseCallbackStatusEnum[keyof typeof ClientBackgroundJobResponseCallbackStatusEnum];
498
+ /**
499
+ * Synchronous batch Probe response with compact per-item results and a small summary block.
500
+ * @export
501
+ * @interface ClientBatchIdentityResponse
502
+ */
503
+ export interface ClientBatchIdentityResponse {
504
+ /**
505
+ * Per-email compact probe results in request order.
506
+ * @type {Array<ClientIdentityResponse>}
507
+ * @memberof ClientBatchIdentityResponse
508
+ */
509
+ results: Array<ClientIdentityResponse>;
510
+ /**
511
+ *
512
+ * @type {BatchSummary}
513
+ * @memberof ClientBatchIdentityResponse
514
+ */
515
+ summary: BatchSummary;
516
+ }
517
+ /**
518
+ * Compact public result envelope used by Finder and Probe style responses.
519
+ * @export
520
+ * @interface ClientFinderResponse
521
+ */
522
+ export interface ClientFinderResponse {
523
+ /**
524
+ * Final public deliverability verdict.
525
+ * @type {ClientFinderResponseStateEnum}
526
+ * @memberof ClientFinderResponse
527
+ */
528
+ state: ClientFinderResponseStateEnum;
529
+ /**
530
+ * Operational outcome. `error` means the verification could not complete cleanly and should not be treated as a negative mailbox verdict.
531
+ * @type {ClientFinderResponseOutcomeEnum}
532
+ * @memberof ClientFinderResponse
533
+ */
534
+ outcome?: ClientFinderResponseOutcomeEnum;
535
+ /**
536
+ *
537
+ * @type {string}
538
+ * @memberof ClientFinderResponse
539
+ */
540
+ address?: string | null;
541
+ /**
542
+ * Whether the resolved address is an alias rather than a primary mailbox.
543
+ * @type {boolean}
544
+ * @memberof ClientFinderResponse
545
+ */
546
+ isAlias?: boolean;
547
+ /**
548
+ *
549
+ * @type {ClientFinderResponseAlias}
550
+ * @memberof ClientFinderResponse
551
+ */
552
+ alias?: ClientFinderResponseAlias;
553
+ /**
554
+ * Whether the mailbox domain behaved like a catch-all during verification.
555
+ * @type {boolean}
556
+ * @memberof ClientFinderResponse
557
+ */
558
+ isCatchall?: boolean;
559
+ /**
560
+ * Identity providers associated with the mailbox domain when available.
561
+ * @type {Array<IdentityProvider>}
562
+ * @memberof ClientFinderResponse
563
+ */
564
+ identityProviders?: Array<IdentityProvider>;
565
+ /**
566
+ * Observed MX hosts for the mailbox domain.
567
+ * @type {Array<string>}
568
+ * @memberof ClientFinderResponse
569
+ */
570
+ mxHosts?: Array<string>;
571
+ /**
572
+ *
573
+ * @type {string}
574
+ * @memberof ClientFinderResponse
575
+ */
576
+ requestId?: string | null;
577
+ }
578
+ /**
579
+ * @export
580
+ */
581
+ export declare const ClientFinderResponseStateEnum: {
582
+ readonly Deliverable: "deliverable";
583
+ readonly Undeliverable: "undeliverable";
584
+ };
585
+ export type ClientFinderResponseStateEnum = typeof ClientFinderResponseStateEnum[keyof typeof ClientFinderResponseStateEnum];
586
+ /**
587
+ * @export
588
+ */
589
+ export declare const ClientFinderResponseOutcomeEnum: {
590
+ readonly Found: "found";
591
+ readonly NotFound: "not_found";
592
+ readonly Error: "error";
593
+ };
594
+ export type ClientFinderResponseOutcomeEnum = typeof ClientFinderResponseOutcomeEnum[keyof typeof ClientFinderResponseOutcomeEnum];
595
+ /**
596
+ * Alias metadata when `is_alias=true`.
597
+ * @export
598
+ * @interface ClientFinderResponseAlias
599
+ */
600
+ export interface ClientFinderResponseAlias {
601
+ /**
602
+ *
603
+ * @type {string}
604
+ * @memberof ClientFinderResponseAlias
605
+ */
606
+ original?: string | null;
607
+ /**
608
+ *
609
+ * @type {string}
610
+ * @memberof ClientFinderResponseAlias
611
+ */
612
+ resolved?: string | null;
613
+ }
614
+ /**
615
+ * Compact public result envelope used by Finder and Probe style responses.
616
+ * @export
617
+ * @interface ClientIdentityResponse
618
+ */
619
+ export interface ClientIdentityResponse {
620
+ /**
621
+ * Final public deliverability verdict.
622
+ * @type {ClientIdentityResponseStateEnum}
623
+ * @memberof ClientIdentityResponse
624
+ */
625
+ state: ClientIdentityResponseStateEnum;
626
+ /**
627
+ * Operational outcome. `error` means the verification could not complete cleanly and should not be treated as a negative mailbox verdict.
628
+ * @type {ClientIdentityResponseOutcomeEnum}
629
+ * @memberof ClientIdentityResponse
630
+ */
631
+ outcome?: ClientIdentityResponseOutcomeEnum;
632
+ /**
633
+ *
634
+ * @type {string}
635
+ * @memberof ClientIdentityResponse
636
+ */
637
+ address?: string | null;
638
+ /**
639
+ * Whether the resolved address is an alias rather than a primary mailbox.
640
+ * @type {boolean}
641
+ * @memberof ClientIdentityResponse
642
+ */
643
+ isAlias?: boolean;
644
+ /**
645
+ *
646
+ * @type {ClientFinderResponseAlias}
647
+ * @memberof ClientIdentityResponse
648
+ */
649
+ alias?: ClientFinderResponseAlias;
650
+ /**
651
+ * Whether the mailbox domain behaved like a catch-all during verification.
652
+ * @type {boolean}
653
+ * @memberof ClientIdentityResponse
654
+ */
655
+ isCatchall?: boolean;
656
+ /**
657
+ * Identity providers associated with the mailbox domain when available.
658
+ * @type {Array<IdentityProvider>}
659
+ * @memberof ClientIdentityResponse
660
+ */
661
+ identityProviders?: Array<IdentityProvider>;
662
+ /**
663
+ * Observed MX hosts for the mailbox domain.
664
+ * @type {Array<string>}
665
+ * @memberof ClientIdentityResponse
666
+ */
667
+ mxHosts?: Array<string>;
668
+ /**
669
+ *
670
+ * @type {string}
671
+ * @memberof ClientIdentityResponse
672
+ */
673
+ requestId?: string | null;
674
+ }
675
+ /**
676
+ * @export
677
+ */
678
+ export declare const ClientIdentityResponseStateEnum: {
679
+ readonly Deliverable: "deliverable";
680
+ readonly Undeliverable: "undeliverable";
681
+ };
682
+ export type ClientIdentityResponseStateEnum = typeof ClientIdentityResponseStateEnum[keyof typeof ClientIdentityResponseStateEnum];
683
+ /**
684
+ * @export
685
+ */
686
+ export declare const ClientIdentityResponseOutcomeEnum: {
687
+ readonly Found: "found";
688
+ readonly NotFound: "not_found";
689
+ readonly Error: "error";
690
+ };
691
+ export type ClientIdentityResponseOutcomeEnum = typeof ClientIdentityResponseOutcomeEnum[keyof typeof ClientIdentityResponseOutcomeEnum];
692
+ /**
693
+ * One completed direct request visible in the user's request history.
694
+ * @export
695
+ * @interface ClientRequestHistoryItem
696
+ */
697
+ export interface ClientRequestHistoryItem {
698
+ /**
699
+ *
700
+ * @type {string}
701
+ * @memberof ClientRequestHistoryItem
702
+ */
703
+ id: string;
704
+ /**
705
+ *
706
+ * @type {ClientRequestHistoryItemRequestTypeEnum}
707
+ * @memberof ClientRequestHistoryItem
708
+ */
709
+ requestType: ClientRequestHistoryItemRequestTypeEnum;
710
+ /**
711
+ *
712
+ * @type {string}
713
+ * @memberof ClientRequestHistoryItem
714
+ */
715
+ inputName?: string | null;
716
+ /**
717
+ *
718
+ * @type {string}
719
+ * @memberof ClientRequestHistoryItem
720
+ */
721
+ inputDomain?: string | null;
722
+ /**
723
+ *
724
+ * @type {string}
725
+ * @memberof ClientRequestHistoryItem
726
+ */
727
+ inputEmail?: string | null;
728
+ /**
729
+ * Compact human-readable identifier for the original request input.
730
+ * @type {string}
731
+ * @memberof ClientRequestHistoryItem
732
+ */
733
+ inputLabel: string;
734
+ /**
735
+ *
736
+ * @type {ClientRequestHistoryItemStateEnum}
737
+ * @memberof ClientRequestHistoryItem
738
+ */
739
+ state: ClientRequestHistoryItemStateEnum;
740
+ /**
741
+ *
742
+ * @type {ClientRequestHistoryItemOutcomeEnum}
743
+ * @memberof ClientRequestHistoryItem
744
+ */
745
+ outcome: ClientRequestHistoryItemOutcomeEnum;
746
+ /**
747
+ *
748
+ * @type {string}
749
+ * @memberof ClientRequestHistoryItem
750
+ */
751
+ resolvedAddress?: string | null;
752
+ /**
753
+ *
754
+ * @type {number}
755
+ * @memberof ClientRequestHistoryItem
756
+ */
757
+ durationMs?: number | null;
758
+ /**
759
+ *
760
+ * @type {string}
761
+ * @memberof ClientRequestHistoryItem
762
+ */
763
+ provider?: string | null;
764
+ /**
765
+ *
766
+ * @type {Array<{ [key: string]: any; }>}
767
+ * @memberof ClientRequestHistoryItem
768
+ */
769
+ identityProviders?: Array<{
770
+ [key: string]: any;
771
+ }>;
772
+ /**
773
+ *
774
+ * @type {Array<string>}
775
+ * @memberof ClientRequestHistoryItem
776
+ */
777
+ mxHosts?: Array<string>;
778
+ /**
779
+ * Small transport and outcome metadata associated with the request.
780
+ * @type {{ [key: string]: any; }}
781
+ * @memberof ClientRequestHistoryItem
782
+ */
783
+ metadata?: {
784
+ [key: string]: any;
785
+ };
786
+ /**
787
+ *
788
+ * @type {boolean}
789
+ * @memberof ClientRequestHistoryItem
790
+ */
791
+ isAlias?: boolean;
792
+ /**
793
+ *
794
+ * @type {boolean}
795
+ * @memberof ClientRequestHistoryItem
796
+ */
797
+ isCatchall?: boolean;
798
+ /**
799
+ *
800
+ * @type {string}
801
+ * @memberof ClientRequestHistoryItem
802
+ */
803
+ requestId?: string | null;
804
+ /**
805
+ *
806
+ * @type {string}
807
+ * @memberof ClientRequestHistoryItem
808
+ */
809
+ createdAt: string;
810
+ }
811
+ /**
812
+ * @export
813
+ */
814
+ export declare const ClientRequestHistoryItemRequestTypeEnum: {
815
+ readonly Finder: "finder";
816
+ readonly Probe: "probe";
817
+ };
818
+ export type ClientRequestHistoryItemRequestTypeEnum = typeof ClientRequestHistoryItemRequestTypeEnum[keyof typeof ClientRequestHistoryItemRequestTypeEnum];
819
+ /**
820
+ * @export
821
+ */
822
+ export declare const ClientRequestHistoryItemStateEnum: {
823
+ readonly Deliverable: "deliverable";
824
+ readonly Undeliverable: "undeliverable";
825
+ };
826
+ export type ClientRequestHistoryItemStateEnum = typeof ClientRequestHistoryItemStateEnum[keyof typeof ClientRequestHistoryItemStateEnum];
827
+ /**
828
+ * @export
829
+ */
830
+ export declare const ClientRequestHistoryItemOutcomeEnum: {
831
+ readonly Found: "found";
832
+ readonly NotFound: "not_found";
833
+ readonly Error: "error";
834
+ };
835
+ export type ClientRequestHistoryItemOutcomeEnum = typeof ClientRequestHistoryItemOutcomeEnum[keyof typeof ClientRequestHistoryItemOutcomeEnum];
836
+ /**
837
+ * Paginated request history result.
838
+ * @export
839
+ * @interface ClientRequestHistoryPageResponse
840
+ */
841
+ export interface ClientRequestHistoryPageResponse {
842
+ /**
843
+ *
844
+ * @type {Array<ClientRequestHistoryItem>}
845
+ * @memberof ClientRequestHistoryPageResponse
846
+ */
847
+ items: Array<ClientRequestHistoryItem>;
848
+ /**
849
+ *
850
+ * @type {number}
851
+ * @memberof ClientRequestHistoryPageResponse
852
+ */
853
+ total: number;
854
+ /**
855
+ *
856
+ * @type {number}
857
+ * @memberof ClientRequestHistoryPageResponse
858
+ */
859
+ page: number;
860
+ /**
861
+ *
862
+ * @type {number}
863
+ * @memberof ClientRequestHistoryPageResponse
864
+ */
865
+ pageSize: number;
866
+ /**
867
+ *
868
+ * @type {number}
869
+ * @memberof ClientRequestHistoryPageResponse
870
+ */
871
+ totalPages: number;
872
+ }
873
+ /**
874
+ * Current bearer token claims as seen by the API.
875
+ * @export
876
+ * @interface ClientTokenStatusResponse
877
+ */
878
+ export interface ClientTokenStatusResponse {
879
+ /**
880
+ * Whether the current bearer token is valid for this request.
881
+ * @type {boolean}
882
+ * @memberof ClientTokenStatusResponse
883
+ */
884
+ valid?: boolean;
885
+ /**
886
+ * User id associated with the bearer token.
887
+ * @type {string}
888
+ * @memberof ClientTokenStatusResponse
889
+ */
890
+ userId: string;
891
+ /**
892
+ * How the bearer token was issued.
893
+ * @type {ClientTokenStatusResponseTokenTypeEnum}
894
+ * @memberof ClientTokenStatusResponse
895
+ */
896
+ tokenType: ClientTokenStatusResponseTokenTypeEnum;
897
+ /**
898
+ * Scopes currently attached to the bearer token.
899
+ * @type {Array<string>}
900
+ * @memberof ClientTokenStatusResponse
901
+ */
902
+ scopes?: Array<string>;
903
+ /**
904
+ *
905
+ * @type {string}
906
+ * @memberof ClientTokenStatusResponse
907
+ */
908
+ expiresAt?: string | null;
909
+ /**
910
+ *
911
+ * @type {number}
912
+ * @memberof ClientTokenStatusResponse
913
+ */
914
+ expiresInSeconds?: number | null;
915
+ }
916
+ /**
917
+ * @export
918
+ */
919
+ export declare const ClientTokenStatusResponseTokenTypeEnum: {
920
+ readonly Pat: "pat";
921
+ readonly Oauth: "oauth";
922
+ };
923
+ export type ClientTokenStatusResponseTokenTypeEnum = typeof ClientTokenStatusResponseTokenTypeEnum[keyof typeof ClientTokenStatusResponseTokenTypeEnum];
924
+ /**
925
+ * Current authenticated account usage, free-tier windows, and paid balance snapshot.
926
+ * @export
927
+ * @interface ClientUsageResponse
928
+ */
929
+ export interface ClientUsageResponse {
930
+ /**
931
+ * Current plan family, such as free or paid.
932
+ * @type {string}
933
+ * @memberof ClientUsageResponse
934
+ */
935
+ planTier: string;
936
+ /**
937
+ *
938
+ * @type {string}
939
+ * @memberof ClientUsageResponse
940
+ */
941
+ billingMode: string;
942
+ /**
943
+ *
944
+ * @type {string}
945
+ * @memberof ClientUsageResponse
946
+ */
947
+ billingStatus?: string | null;
948
+ /**
949
+ *
950
+ * @type {number}
951
+ * @memberof ClientUsageResponse
952
+ */
953
+ freeWindowLimit: number;
954
+ /**
955
+ *
956
+ * @type {number}
957
+ * @memberof ClientUsageResponse
958
+ */
959
+ freeWindowHours: number;
960
+ /**
961
+ *
962
+ * @type {number}
963
+ * @memberof ClientUsageResponse
964
+ */
965
+ freeWeeklyLimit: number;
966
+ /**
967
+ *
968
+ * @type {number}
969
+ * @memberof ClientUsageResponse
970
+ */
971
+ windowRequestsUsed: number;
972
+ /**
973
+ *
974
+ * @type {number}
975
+ * @memberof ClientUsageResponse
976
+ */
977
+ weeklyRequestsUsed: number;
978
+ /**
979
+ *
980
+ * @type {number}
981
+ * @memberof ClientUsageResponse
982
+ */
983
+ windowRequestsRemaining: number;
984
+ /**
985
+ *
986
+ * @type {number}
987
+ * @memberof ClientUsageResponse
988
+ */
989
+ weeklyRequestsRemaining: number;
990
+ /**
991
+ *
992
+ * @type {number}
993
+ * @memberof ClientUsageResponse
994
+ */
995
+ billingCycleValueMicros?: number | null;
996
+ /**
997
+ *
998
+ * @type {number}
999
+ * @memberof ClientUsageResponse
1000
+ */
1001
+ billingExtraValueMicros: number;
1002
+ /**
1003
+ *
1004
+ * @type {number}
1005
+ * @memberof ClientUsageResponse
1006
+ */
1007
+ billingValueMicrosUsed: number;
1008
+ /**
1009
+ * Paid usage value currently reserved by queued or running background jobs.
1010
+ * @type {number}
1011
+ * @memberof ClientUsageResponse
1012
+ */
1013
+ billingValueMicrosReserved?: number;
1014
+ /**
1015
+ *
1016
+ * @type {number}
1017
+ * @memberof ClientUsageResponse
1018
+ */
1019
+ billingValueMicrosRemaining?: number | null;
1020
+ /**
1021
+ *
1022
+ * @type {number}
1023
+ * @memberof ClientUsageResponse
1024
+ */
1025
+ usagePercentRemaining?: number | null;
1026
+ /**
1027
+ *
1028
+ * @type {number}
1029
+ * @memberof ClientUsageResponse
1030
+ */
1031
+ currentPlanFinderDeliverableCostMicros?: number | null;
1032
+ /**
1033
+ *
1034
+ * @type {number}
1035
+ * @memberof ClientUsageResponse
1036
+ */
1037
+ currentPlanFinderUndeliverableCostMicros?: number | null;
1038
+ /**
1039
+ *
1040
+ * @type {number}
1041
+ * @memberof ClientUsageResponse
1042
+ */
1043
+ currentPlanProbeCostMicros?: number | null;
1044
+ }
1045
+ /**
1046
+ *
1047
+ * @export
1048
+ * @interface ErrorResponse
1049
+ */
1050
+ export interface ErrorResponse {
1051
+ /**
1052
+ * Stable machine-readable error key.
1053
+ * @type {string}
1054
+ * @memberof ErrorResponse
1055
+ */
1056
+ error?: string;
1057
+ /**
1058
+ * Human-friendly error summary safe to show to an operator or end user.
1059
+ * @type {string}
1060
+ * @memberof ErrorResponse
1061
+ */
1062
+ message?: string;
1063
+ /**
1064
+ * Optional raw backend detail when available.
1065
+ * @type {string}
1066
+ * @memberof ErrorResponse
1067
+ */
1068
+ detail?: string;
1069
+ /**
1070
+ *
1071
+ * @type {number}
1072
+ * @memberof ErrorResponse
1073
+ */
1074
+ retryAfterSeconds?: number | null;
1075
+ }
1076
+ /**
1077
+ * Queue a background Finder workload that can wait for capacity and complete asynchronously.
1078
+ * @export
1079
+ * @interface FinderBatchJobRequest
1080
+ */
1081
+ export interface FinderBatchJobRequest {
1082
+ /**
1083
+ * Optional hard deadline for the job. Omit it to start as soon as capacity allows. If provided, the API returns 422 when the deadline is too tight even with immediate execution.
1084
+ * @type {string}
1085
+ * @memberof FinderBatchJobRequest
1086
+ */
1087
+ deadline?: string;
1088
+ /**
1089
+ *
1090
+ * @type {string}
1091
+ * @memberof FinderBatchJobRequest
1092
+ */
1093
+ callbackUrl?: string | null;
1094
+ /**
1095
+ * One or more Finder-style inputs that will be processed asynchronously.
1096
+ * @type {Array<FinderBatchJobRequestInputsInner>}
1097
+ * @memberof FinderBatchJobRequest
1098
+ */
1099
+ inputs: Array<FinderBatchJobRequestInputsInner>;
1100
+ }
1101
+ /**
1102
+ *
1103
+ * @export
1104
+ * @interface FinderBatchJobRequestInputsInner
1105
+ */
1106
+ export interface FinderBatchJobRequestInputsInner {
1107
+ /**
1108
+ * The real person's full name.
1109
+ * @type {string}
1110
+ * @memberof FinderBatchJobRequestInputsInner
1111
+ */
1112
+ fullName: string;
1113
+ /**
1114
+ * The company website or mailbox domain.
1115
+ * @type {string}
1116
+ * @memberof FinderBatchJobRequestInputsInner
1117
+ */
1118
+ emailDomain: string;
1119
+ }
1120
+ /**
1121
+ * Resolve the most likely verified work email for one person at one company domain.
1122
+ * @export
1123
+ * @interface FinderRequest
1124
+ */
1125
+ export interface FinderRequest {
1126
+ /**
1127
+ * The real person's full name. Include middle names or initials when known.
1128
+ * @type {string}
1129
+ * @memberof FinderRequest
1130
+ */
1131
+ fullName: string;
1132
+ /**
1133
+ * The company's public website or mailbox domain.
1134
+ * @type {string}
1135
+ * @memberof FinderRequest
1136
+ */
1137
+ emailDomain: string;
1138
+ }
1139
+ /**
1140
+ *
1141
+ * @export
1142
+ * @interface HTTPValidationError
1143
+ */
1144
+ export interface HTTPValidationError {
1145
+ /**
1146
+ *
1147
+ * @type {Array<ValidationError>}
1148
+ * @memberof HTTPValidationError
1149
+ */
1150
+ detail?: Array<ValidationError>;
1151
+ }
1152
+ /**
1153
+ *
1154
+ * @export
1155
+ * @interface IdentityProvider
1156
+ */
1157
+ export interface IdentityProvider {
1158
+ /**
1159
+ *
1160
+ * @type {string}
1161
+ * @memberof IdentityProvider
1162
+ */
1163
+ provider?: string;
1164
+ /**
1165
+ *
1166
+ * @type {string}
1167
+ * @memberof IdentityProvider
1168
+ */
1169
+ hostname?: string | null;
1170
+ }
1171
+ /**
1172
+ *
1173
+ * @export
1174
+ * @interface LocationInner
1175
+ */
1176
+ export interface LocationInner {
1177
+ }
1178
+ /**
1179
+ * Queue a background Probe Batch workload that can wait for capacity and complete asynchronously.
1180
+ * @export
1181
+ * @interface ProbeBatchJobBackgroundRequest
1182
+ */
1183
+ export interface ProbeBatchJobBackgroundRequest {
1184
+ /**
1185
+ * Optional hard deadline for the job. Omit it to start as soon as capacity allows. If provided, the API returns 422 when the deadline is too tight even with immediate execution.
1186
+ * @type {string}
1187
+ * @memberof ProbeBatchJobBackgroundRequest
1188
+ */
1189
+ deadline?: string;
1190
+ /**
1191
+ *
1192
+ * @type {string}
1193
+ * @memberof ProbeBatchJobBackgroundRequest
1194
+ */
1195
+ callbackUrl?: string | null;
1196
+ /**
1197
+ * One or more exact mailbox addresses to verify asynchronously.
1198
+ * @type {Array<string>}
1199
+ * @memberof ProbeBatchJobBackgroundRequest
1200
+ */
1201
+ emails: Array<string>;
1202
+ }
1203
+ /**
1204
+ * Verify many known email addresses synchronously and receive compact per-item results.
1205
+ * @export
1206
+ * @interface ProbeBatchRequest
1207
+ */
1208
+ export interface ProbeBatchRequest {
1209
+ /**
1210
+ * One or more exact mailbox addresses to verify.
1211
+ * @type {Array<string>}
1212
+ * @memberof ProbeBatchRequest
1213
+ */
1214
+ emails: Array<string>;
1215
+ }
1216
+ /**
1217
+ * Verify one known email address directly.
1218
+ * @export
1219
+ * @interface ProbeRequest
1220
+ */
1221
+ export interface ProbeRequest {
1222
+ /**
1223
+ * The email address you want to verify.
1224
+ * @type {string}
1225
+ * @memberof ProbeRequest
1226
+ */
1227
+ email: string;
1228
+ }
1229
+ /**
1230
+ *
1231
+ * @export
1232
+ * @interface ValidationError
1233
+ */
1234
+ export interface ValidationError {
1235
+ /**
1236
+ *
1237
+ * @type {Array<LocationInner>}
1238
+ * @memberof ValidationError
1239
+ */
1240
+ loc: Array<LocationInner>;
1241
+ /**
1242
+ *
1243
+ * @type {string}
1244
+ * @memberof ValidationError
1245
+ */
1246
+ msg: string;
1247
+ /**
1248
+ *
1249
+ * @type {string}
1250
+ * @memberof ValidationError
1251
+ */
1252
+ type: string;
1253
+ /**
1254
+ *
1255
+ * @type {any}
1256
+ * @memberof ValidationError
1257
+ */
1258
+ input?: any | null;
1259
+ /**
1260
+ *
1261
+ * @type {object}
1262
+ * @memberof ValidationError
1263
+ */
1264
+ ctx?: object;
1265
+ }