@outseta/api-client 0.3.0 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,35 @@
1
+ // @ts-nocheck
2
+
3
+ /**
4
+ * Returned from the mid-login enrollment confirm endpoints
5
+ (POST /api/v1/tokens/two-factor/enroll/{email|totp}/confirm) once the
6
+ user has proven control of the new mechanism. Completes a forced-enrollment
7
+ login: it both finalizes the JWT access token and surfaces the freshly
8
+ generated recovery codes. The property names are snake_case to match the
9
+ wire format of the other token endpoints (see TokenPayload).
10
+ */
11
+ export interface TwoFactorEnrollmentConfirmationPayload {
12
+ /** Always true on a success response; the enrollment is now active. */
13
+ confirmed?: boolean;
14
+ /**
15
+ * The user's recovery codes, generated as part of first-time enrollment.
16
+ These are shown once and never returned again — prompt the user
17
+ to store them somewhere safe. Each code is single-use at
18
+ POST /api/v1/tokens/two-factor/recovery.
19
+ * @nullable
20
+ */
21
+ recovery_codes?: string[] | null;
22
+ /**
23
+ * The JWT access token. Use it as Authorization: bearer {access_token}
24
+ for subsequent API calls — login is complete.
25
+ * @nullable
26
+ */
27
+ access_token?: string | null;
28
+ /**
29
+ * Always Bearer.
30
+ * @nullable
31
+ */
32
+ token_type?: string | null;
33
+ /** Seconds until the access token expires. */
34
+ expires_in?: number;
35
+ }
@@ -0,0 +1,39 @@
1
+ // @ts-nocheck
2
+
3
+ /**
4
+ * Returned from POST /api/v1/tokens/two-factor/enroll/totp/begin when a
5
+ user forced into 2FA chooses to enroll an authenticator app. Carries the
6
+ shared secret in the three forms a client may need to present it, plus the
7
+ challenge token the user's first generated code is confirmed against. The
8
+ property names are snake_case to match the wire format of the other token
9
+ endpoints (see TokenPayload).
10
+ */
11
+ export interface TwoFactorTotpEnrollmentPayload {
12
+ /**
13
+ * Short-lived signed JWT identifying the enrollment-test challenge.
14
+ Echo it back to POST /api/v1/tokens/two-factor/enroll/totp/confirm
15
+ along with the first code from the authenticator app.
16
+ * @nullable
17
+ */
18
+ challenge_token?: string | null;
19
+ /**
20
+ * The Base32-encoded shared secret. Offer this for manual entry by users
21
+ who cannot scan the QR code.
22
+ * @nullable
23
+ */
24
+ secret?: string | null;
25
+ /**
26
+ * The full otpauth://totp/... URI encoding the secret, issuer and
27
+ parameters. Most authenticator apps add an account directly from this.
28
+ * @nullable
29
+ */
30
+ otpauth_uri?: string | null;
31
+ /**
32
+ * A QR code rendering of otpauth_uri as a PNG, Base64
33
+ encoded — render it as an <img> for the user to scan.
34
+ * @nullable
35
+ */
36
+ qr_code_png_base64?: string | null;
37
+ /** Seconds until the enrollment-test challenge expires (600). */
38
+ expires_in?: number;
39
+ }