added task pushvariables feature

Author: imagetyperz-api

example/task.js

@@ -18,6 +18,10 @@ async function task() {
         const captchaID = await imagetyperzapi.submit_task(task_params)
         // solve captcha
         log('Waiting for captcha to be solved ...');
+
+        // # send pushVariable - update of variable while task is running (e.g 2FA code)
+        // await imagetyperzapi.task_push_variables(captchaID, {twofactor_code: "32948"})
+
         const response = await imagetyperzapi.retrieve_response(captchaID)
         log(`Response: ${JSON.stringify(response)}`)
     } catch (err) {

lib/imagetyperz-api-client.js

@@ -17,6 +17,7 @@ window.imagetyperz_config = {
         TIKTOK_ENDPOINT: 'http://captchatypers.com/captchaapi/UploadTikTokCaptchaUser.ashx',
         FUNCAPTCHA_ENDPOINT: 'http://captchatypers.com/captchaapi/UploadFunCaptcha.ashx',
         TASK_ENDPOINT: 'http://captchatypers.com/captchaapi/UploadCaptchaTask.ashx',
+        TASK_PUSH_ENDPOINT: 'http://captchatypers.com/CaptchaAPI/SaveCaptchaPush.ashx',
 
         CAPTCHA_ENDPOINT_CONTENT_TOKEN: 'http://captchatypers.com/Forms/UploadFileAndGetTextNEWToken.ashx',
         CAPTCHA_ENDPOINT_URL_TOKEN: 'http://captchatypers.com/Forms/FileUploadAndGetTextCaptchaURLToken.ashx',
@@ -507,6 +508,35 @@ imagetyperzapi.submit_task = function (d) {
     });
 };
 
+// update task captcha pushVariables
+imagetyperzapi.task_push_variables = function (captcha_id, pushVariables) {
+    var ic = imagetyperz_config;    // get config obj
+    return new Promise((resolve, reject) => {
+        var data = {}
+        if (ic.username && ic.password) {
+            // legacy auth
+            data['username'] = ic.username;
+            data['password'] = ic.password;
+        }
+        else {
+            data['token'] = ic.access_key;    // token auth
+        }
+
+        data['action'] = 'GETTEXT';
+        data['captchaid'] = captcha_id
+        data.pushVariables = JSON.stringify(pushVariables)
+
+        // make request
+        $.post(ic.endpoints.TASK_PUSH_ENDPOINT, data).done(function (resp) {
+            // check for error
+            if (resp.indexOf('ERROR:') !== -1) return reject(resp);
+            return resolve(resp);
+        }).fail(function (err) {
+            return reject(err);
+        });
+    });
+};
+
 // retrieve recaptcha
 imagetyperzapi.retrieve_response = function (captcha_id) {
     var ic = imagetyperz_config;    // get config obj

package.json

@@ -1,6 +1,6 @@
 {
   "name": "imagetyperz-api-client",
-  "version": "1.2.8",
+  "version": "1.2.9",
   "description": "ImagetyperzAPI (client) is a super easy to use bypass captcha API wrapper for imagetyperz.com captcha service",
   "main": "lib/imagetyperz-api-client.js",
   "scripts": {

readme.md

@@ -237,7 +237,16 @@ captcha_params = {
 const captchaID = await imagetyperzapi.submit_task(captcha_params)
 ```
 
+#### Task pushVariable
+Update a variable value while task is running. Useful when dealing with 2FA authentication.
 
+When template reaches an action that uses a variable which wasn't provided with the submission of the task,
+task (while running on worker machine) will wait for variable to be updated through push.
+
+You can use the pushVariables method as many times as you need, even overwriting previously set variables.
+```javascript
+await imagetyperzapi.task_push_variables(captchaID, {twofactor_code: "32948"})
+```
 
 ## Retrieve response