rettiwt-api 1.1.1 → 1.1.5

package/dist/services/auth/AccountService.js

@@ -0,0 +1,392 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+exports.__esModule = true;
+exports.AccountService = void 0;
+// PACKAGES
+var node_libcurl_1 = require("node-libcurl");
+// SERVICES
+var AuthService_1 = require("./AuthService");
+// ENUMS
+var HTTP_1 = require("../../enums/HTTP");
+var Errors_1 = require("../../enums/Errors");
+// HELPERS
+var LoginFlows_1 = __importDefault(require("../helper/payloads/LoginFlows"));
+var Headers_1 = require("../helper/Headers");
+var cookiejar_1 = require("cookiejar");
+/**
+ * Handles all operations related to a user's account, such as loggin in, managing account, etc
+ * @public
+ */
+var AccountService = /** @class */ (function () {
+    function AccountService() {
+        this.auth = new AuthService_1.AuthService();
+        this.guestCreds = { authToken: '', guestToken: '' };
+        this.cookies = [];
+        this.flowToken = '';
+    }
+    /**
+     * @returns The current guest credentials to use. If if does not exists, then a new one is created
+     */
+    AccountService.prototype.getGuestCredentials = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (!!this.guestCreds.guestToken) return [3 /*break*/, 2];
+                        _a = this;
+                        return [4 /*yield*/, this.auth.getGuestCredentials()];
+                    case 1:
+                        _a.guestCreds = _b.sent();
+                        _b.label = 2;
+                    case 2: return [2 /*return*/, this.guestCreds];
+                }
+            });
+        });
+    };
+    /**
+     * Step 1: Initiates login
+     * @internal
+     */
+    AccountService.prototype.initiateLogin = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, _a, _b, _c, _d;
+            var _e;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        _b = (_a = node_libcurl_1.curly).post;
+                        _c = [LoginFlows_1["default"].InitiateLogin.url];
+                        _e = {};
+                        _d = Headers_1.loginHeader;
+                        return [4 /*yield*/, this.getGuestCredentials()];
+                    case 1: return [4 /*yield*/, _b.apply(_a, _c.concat([(_e.httpHeader = _d.apply(void 0, [_f.sent(), this.cookies.toString()]),
+                                _e.sslVerifyPeer = false,
+                                _e.postFields = '',
+                                _e)]))];
+                    case 2:
+                        res = _f.sent();
+                        // Storing cookies received
+                        this.cookies = new cookiejar_1.CookieJar().setCookies(res.headers[0]['Set-Cookie']);
+                        // Getting the flow token
+                        this.flowToken = res.data['flow_token'];
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Step 2: Does something
+     * @internal
+     */
+    AccountService.prototype.jsInstrumentationSubtask = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, _a, _b, _c, _d;
+            var _e;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        _b = (_a = node_libcurl_1.curly).post;
+                        _c = [LoginFlows_1["default"].JsInstrumentationSubtask.url];
+                        _e = {};
+                        _d = Headers_1.loginHeader;
+                        return [4 /*yield*/, this.getGuestCredentials()];
+                    case 1: return [4 /*yield*/, _b.apply(_a, _c.concat([(_e.httpHeader = _d.apply(void 0, [_f.sent(), this.cookies.join(';').toString()]),
+                                _e.sslVerifyPeer = false,
+                                _e.postFields = JSON.stringify(LoginFlows_1["default"].JsInstrumentationSubtask.body(this.flowToken)),
+                                _e)]))];
+                    case 2:
+                        res = _f.sent();
+                        // Getting the flow token
+                        this.flowToken = res.data['flow_token'];
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Step 3: Takes the email for login
+     * @internal
+     *
+     * @throws {@link AuthenticationErrors.InvalidEmail}, if email does not exist.
+     */
+    AccountService.prototype.enterUserIdentifier = function (email) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, _a, _b, _c, _d;
+            var _e;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        _b = (_a = node_libcurl_1.curly).post;
+                        _c = [LoginFlows_1["default"].EnterUserIdentifier.url];
+                        _e = {};
+                        _d = Headers_1.loginHeader;
+                        return [4 /*yield*/, this.getGuestCredentials()];
+                    case 1: return [4 /*yield*/, _b.apply(_a, _c.concat([(_e.httpHeader = _d.apply(void 0, [_f.sent(), this.cookies.join(';').toString()]),
+                                _e.sslVerifyPeer = false,
+                                _e.postFields = JSON.stringify(LoginFlows_1["default"].EnterUserIdentifier.body(this.flowToken, email)),
+                                _e)]))];
+                    case 2:
+                        res = _f.sent();
+                        // If no account found with given email
+                        if (res.statusCode == HTTP_1.HttpStatus.BadRequest && res.data.errors[0].code == 399) {
+                            throw new Error(Errors_1.AuthenticationErrors.InvalidEmail);
+                        }
+                        // Getting the flow token
+                        this.flowToken = res.data['flow_token'];
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Step 4: Takes the username for login
+     * @internal
+     *
+     * @throws {@link AuthenticationErrors.InvalidUsername}, if wrong username entered.
+     */
+    AccountService.prototype.enterAlternateUserIdentifier = function (userName) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, _a, _b, _c, _d;
+            var _e;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        _b = (_a = node_libcurl_1.curly).post;
+                        _c = [LoginFlows_1["default"].EnterAlternateUserIdentifier.url];
+                        _e = {};
+                        _d = Headers_1.loginHeader;
+                        return [4 /*yield*/, this.getGuestCredentials()];
+                    case 1: return [4 /*yield*/, _b.apply(_a, _c.concat([(_e.httpHeader = _d.apply(void 0, [_f.sent(), this.cookies.join(';').toString()]),
+                                _e.sslVerifyPeer = false,
+                                _e.postFields = JSON.stringify(LoginFlows_1["default"].EnterAlternateUserIdentifier.body(this.flowToken, userName)),
+                                _e)]))];
+                    case 2:
+                        res = _f.sent();
+                        // If invalid username for the given account
+                        if (res.statusCode == HTTP_1.HttpStatus.BadRequest && res.data.errors[0].code == 399) {
+                            throw new Error(Errors_1.AuthenticationErrors.InvalidUsername);
+                        }
+                        // Getting the flow token
+                        this.flowToken = res.data['flow_token'];
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Step 5: Takes the password for login
+     * @internal
+     *
+     * @throws {@link AuthenticationErrors.InvalidPassword}, incorrect password entered.
+     */
+    AccountService.prototype.enterPassword = function (password) {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, _a, _b, _c, _d;
+            var _e;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        _b = (_a = node_libcurl_1.curly).post;
+                        _c = [LoginFlows_1["default"].EnterPassword.url];
+                        _e = {};
+                        _d = Headers_1.loginHeader;
+                        return [4 /*yield*/, this.getGuestCredentials()];
+                    case 1: return [4 /*yield*/, _b.apply(_a, _c.concat([(_e.httpHeader = _d.apply(void 0, [_f.sent(), this.cookies.join(';').toString()]),
+                                _e.sslVerifyPeer = false,
+                                _e.postFields = JSON.stringify(LoginFlows_1["default"].EnterPassword.body(this.flowToken, password)),
+                                _e)]))];
+                    case 2:
+                        res = _f.sent();
+                        // If invalid password for the given account
+                        if (res.statusCode == HTTP_1.HttpStatus.BadRequest && res.data.errors[0].code == 399) {
+                            throw new Error(Errors_1.AuthenticationErrors.InvalidPassword);
+                        }
+                        // Getting the flow token
+                        this.flowToken = res.data['flow_token'];
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Step 6: Gets the actual cookies
+     * @internal
+     */
+    AccountService.prototype.accountDuplicationCheck = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var res, _a, _b, _c, _d;
+            var _e;
+            return __generator(this, function (_f) {
+                switch (_f.label) {
+                    case 0:
+                        _b = (_a = node_libcurl_1.curly).post;
+                        _c = [LoginFlows_1["default"].AccountDuplicationCheck.url];
+                        _e = {};
+                        _d = Headers_1.loginHeader;
+                        return [4 /*yield*/, this.getGuestCredentials()];
+                    case 1: return [4 /*yield*/, _b.apply(_a, _c.concat([(_e.httpHeader = _d.apply(void 0, [_f.sent(), this.cookies.join(';').toString()]),
+                                _e.sslVerifyPeer = false,
+                                _e.postFields = JSON.stringify(LoginFlows_1["default"].AccountDuplicationCheck.body(this.flowToken)),
+                                _e)]))];
+                    case 2:
+                        res = _f.sent();
+                        // Getting the cookies from the set-cookie header of the reponse.
+                        this.cookies = new cookiejar_1.CookieJar().setCookies(res.headers[0]['Set-Cookie']);
+                        // Getting the flow token
+                        this.flowToken = res.data['flow_token'];
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Execute all the flows required to login to Twitter, using the given credentials, then set the response cookies.
+     *
+     * @internal
+     *
+     * @param email The email of the account to be logged into.
+     * @param userName The username associated with the given account.
+     * @param password The password to the account.
+     */
+    AccountService.prototype.executeLoginFlows = function (email, userName, password) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: 
+                    /**
+                     * This works by sending a chain of request that are required for login to twitter.
+                     * Each method in the chain returns a flow token that must be provied as payload in the next method in the chain.
+                     * Each such method is called a subtask.
+                     * Each subtask sets the {@link flowToken} property of the class which is then given in the payload of the next subtask.
+                     * The final subtask returns the headers which actually contains the cookie in the 'set-cookie' field.
+                     */
+                    return [4 /*yield*/, this.initiateLogin()];
+                    case 1:
+                        /**
+                         * This works by sending a chain of request that are required for login to twitter.
+                         * Each method in the chain returns a flow token that must be provied as payload in the next method in the chain.
+                         * Each such method is called a subtask.
+                         * Each subtask sets the {@link flowToken} property of the class which is then given in the payload of the next subtask.
+                         * The final subtask returns the headers which actually contains the cookie in the 'set-cookie' field.
+                         */
+                        _a.sent();
+                        return [4 /*yield*/, this.jsInstrumentationSubtask()];
+                    case 2:
+                        _a.sent();
+                        return [4 /*yield*/, this.enterUserIdentifier(email)];
+                    case 3:
+                        _a.sent();
+                        return [4 /*yield*/, this.enterAlternateUserIdentifier(userName)];
+                    case 4:
+                        _a.sent();
+                        return [4 /*yield*/, this.enterPassword(password)];
+                    case 5:
+                        _a.sent();
+                        return [4 /*yield*/, this.accountDuplicationCheck()];
+                    case 6:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Parse the authentication cookies recieved from Twitter into known format.
+     *
+     * @internal
+     *
+     * @param cookies The raw cookies received from Twitter.
+     *
+     * @returns The parsed cookies of type {@link AuthCookie}
+     */
+    AccountService.prototype.parseCookies = function (cookies) {
+        /** The tempoorary parsed cookies. */
+        var tempCookies = {};
+        /**
+         * Parsing the cookies into a standard JSON format.
+         * The format is 'cookie_name': 'cookie_value'.
+         * All other cookie parameters like expiry, etc are dropped.
+         */
+        cookies.forEach(function (cookie) {
+            tempCookies[cookie.name] = cookie.value;
+        });
+        return {
+            kdt: tempCookies['kdt'],
+            twid: tempCookies['twid'],
+            ct0: tempCookies['ct0'],
+            auth_token: tempCookies['auth_token']
+        };
+    };
+    /**
+     * Login to Twitter using the given credentials and get back the cookies.
+     *
+     * @public
+     *
+     * @param email The email of the account to be logged into.
+     * @param userName The username associated with the given account.
+     * @param password The password to the account.
+     *
+     * @returns The cookies for authenticating with the given account.
+     */
+    AccountService.prototype.login = function (email, userName, password) {
+        return __awaiter(this, void 0, void 0, function () {
+            var parsedCookies;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: 
+                    // Executing all login flows
+                    return [4 /*yield*/, this.executeLoginFlows(email, userName, password)];
+                    case 1:
+                        // Executing all login flows
+                        _a.sent();
+                        // Parsing the cookies
+                        parsedCookies = this.parseCookies(this.cookies);
+                        // Returning the final parsed cookies
+                        return [2 /*return*/, parsedCookies];
+                }
+            });
+        });
+    };
+    return AccountService;
+}());
+exports.AccountService = AccountService;
+//# sourceMappingURL=AccountService.js.map

package/dist/services/auth/AccountService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountService.js","sourceRoot":"","sources":["../../../src/services/auth/AccountService.ts"],"names":[],"mappings":"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"}

package/dist/services/auth/AuthService.d.ts

@@ -0,0 +1,31 @@
+import { AuthCookie } from '../../models/auth/AuthCookie';
+import { IGuestCredentials, IAuthCredentials } from '../../types/Authentication';
+/**
+ * Handles authentication of http requests and other authentication related tasks.
+ *
+ * @internal
+ */
+export declare class AuthService {
+    /** The common bearer token for authentication. */
+    private authToken;
+    /** The current authentication credentials. */
+    private credentials;
+    /** Whether instance has been authenticated or not. */
+    isAuthenticated: boolean;
+    /**
+     * @param cookie The cookie to be used for authenticating.
+     *
+     * @remarks
+     *
+     * If no cookie is supplied, then guest authentication is used.
+     */
+    constructor(cookie?: AuthCookie);
+    /**
+     * @returns The current authentication credentials. A different credential is returned each time this is invoked
+     */
+    getAuthCredentials(): Promise<IAuthCredentials>;
+    /**
+     * @returns The guest credentials fetched from twitter.
+     */
+    getGuestCredentials(): Promise<IGuestCredentials>;
+}

package/dist/services/auth/AuthService.js

@@ -0,0 +1,118 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+exports.__esModule = true;
+exports.AuthService = void 0;
+// PACKAGE
+var axios_1 = __importDefault(require("axios"));
+// URLS
+var Authentication_1 = require("../helper/urls/Authentication");
+// MODELS
+var AuthCookie_1 = require("../../models/auth/AuthCookie");
+// CONFIGS
+var env_1 = require("../../config/env");
+/**
+ * Handles authentication of http requests and other authentication related tasks.
+ *
+ * @internal
+ */
+var AuthService = /** @class */ (function () {
+    /**
+     * @param cookie The cookie to be used for authenticating.
+     *
+     * @remarks
+     *
+     * If no cookie is supplied, then guest authentication is used.
+     */
+    function AuthService(cookie) {
+        // Reading the auth token from the config, since it's always the same
+        this.authToken = env_1.config.twitter_auth_token;
+        // Setting authentication status
+        this.isAuthenticated = ((cookie === null || cookie === void 0 ? void 0 : cookie.auth_token) && (cookie === null || cookie === void 0 ? void 0 : cookie.ct0) && (cookie === null || cookie === void 0 ? void 0 : cookie.kdt) && (cookie === null || cookie === void 0 ? void 0 : cookie.twid)) ? true : false;
+        // If a cookies is supplied, initializing authenticated credentials
+        if (this.isAuthenticated) {
+            // Converting the cookie from JSON to object
+            cookie = new AuthCookie_1.AuthCookie(cookie);
+            // Setting up the authenticated credentials
+            this.credentials = { authToken: this.authToken, csrfToken: cookie.ct0, cookie: cookie.toString() };
+        }
+        // If no cookie has been supplied, initializing empty credentials
+        else {
+            // Setting up the authenticated credentials
+            this.credentials = { authToken: this.authToken, csrfToken: '', cookie: '' };
+        }
+    }
+    /**
+     * @returns The current authentication credentials. A different credential is returned each time this is invoked
+     */
+    AuthService.prototype.getAuthCredentials = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.credentials];
+            });
+        });
+    };
+    /**
+     * @returns The guest credentials fetched from twitter.
+     */
+    AuthService.prototype.getGuestCredentials = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, axios_1["default"].post((0, Authentication_1.guestTokenUrl)(), null, {
+                            headers: {
+                                'Authorization': this.authToken
+                            }
+                        }).then(function (res) { return ({
+                            authToken: _this.authToken,
+                            guestToken: res.data.guest_token
+                        }); })];
+                    case 1: 
+                    // Getting the guest credentials from twitter
+                    return [2 /*return*/, _a.sent()];
+                }
+            });
+        });
+    };
+    return AuthService;
+}());
+exports.AuthService = AuthService;
+//# sourceMappingURL=AuthService.js.map

package/dist/services/auth/AuthService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthService.js","sourceRoot":"","sources":["../../../src/services/auth/AuthService.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,UAAU;AACV,gDAA0B;AAE1B,OAAO;AACP,gEAA8D;AAE9D,SAAS;AACT,2DAA0D;AAK1D,UAAU;AACV,wCAA0C;AAE1C;;;;GAIG;AACH;IAUI;;;;;;OAMG;IACH,qBAAY,MAAmB;QAC3B,qEAAqE;QACrE,IAAI,CAAC,SAAS,GAAG,YAAM,CAAC,kBAAkB,CAAC;QAE3C,gCAAgC;QAChC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,UAAU,MAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAA,KAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,GAAG,CAAA,KAAI,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAA,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAEzG,mEAAmE;QACnE,IAAI,IAAI,CAAC,eAAe,EAAE;YACtB,4CAA4C;YAC5C,MAAM,GAAG,IAAI,uBAAU,CAAC,MAAM,CAAC,CAAC;YAEhC,2CAA2C;YAC3C,IAAI,CAAC,WAAW,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;SACtG;QACD,iEAAiE;aAC5D;YACD,2CAA2C;YAC3C,IAAI,CAAC,WAAW,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;SAC/E;IACL,CAAC;IAED;;OAEG;IACG,wCAAkB,GAAxB;;;gBACI,sBAAO,IAAI,CAAC,WAAW,EAAC;;;KAC3B;IAED;;OAEG;IACG,yCAAmB,GAAzB;;;;;4BAEW,qBAAM,kBAAK,CAAC,IAAI,CAA0B,IAAA,8BAAa,GAAE,EAAE,IAAI,EAAE;4BACpE,OAAO,EAAE;gCACL,eAAe,EAAE,IAAI,CAAC,SAAS;6BAClC;yBACJ,CAAC,CAAC,IAAI,CAAC,UAAA,GAAG,IAAI,OAAA,CAAC;4BACZ,SAAS,EAAE,KAAI,CAAC,SAAS;4BACzB,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW;yBACnC,CAAC,EAHa,CAGb,CAAC,EAAA;;oBARH,6CAA6C;oBAC7C,sBAAO,SAOJ,EAAC;;;;KACP;IACL,kBAAC;AAAD,CAAC,AA5DD,IA4DC;AA5DY,kCAAW"}

package/dist/services/auth/LoginFlows.d.ts

@@ -0,0 +1,77 @@
+declare const LoginFlows: {
+    InitiateLogin: {
+        url: string;
+    };
+    JsInstrumentationSubtask: {
+        url: string;
+        body: (flowToken: string) => {
+            flow_token: string;
+            subtask_inputs: {
+                subtask_id: string;
+                js_instrumentation: {
+                    response: string;
+                    link: string;
+                };
+            }[];
+        };
+    };
+    EnterUserIdentifier: {
+        url: string;
+        body: (flowToken: string, email: string) => {
+            flow_token: string;
+            subtask_inputs: {
+                subtask_id: string;
+                settings_list: {
+                    setting_responses: {
+                        key: string;
+                        response_data: {
+                            text_data: {
+                                result: string;
+                            };
+                        };
+                    }[];
+                    link: string;
+                };
+            }[];
+        };
+    };
+    EnterAlternateUserIdentifier: {
+        url: string;
+        body: (flowToken: string, userName: string) => {
+            flow_token: string;
+            subtask_inputs: {
+                subtask_id: string;
+                enter_text: {
+                    text: string;
+                    link: string;
+                };
+            }[];
+        };
+    };
+    EnterPassword: {
+        url: string;
+        body: (flowToken: string, password: string) => {
+            flow_token: string;
+            subtask_inputs: {
+                subtask_id: string;
+                enter_password: {
+                    password: string;
+                    link: string;
+                };
+            }[];
+        };
+    };
+    AccountDuplicationCheck: {
+        url: string;
+        body: (flowToken: string) => {
+            flow_token: string;
+            subtask_inputs: {
+                subtask_id: string;
+                check_logged_in_account: {
+                    link: string;
+                };
+            }[];
+        };
+    };
+};
+export default LoginFlows;