apify 3.0.4-beta.45 → 3.1.0

package/{dist/actor.js → actor.js}

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EXIT_CODES = exports.Actor = void 0;
 const tslib_1 = require("tslib");
 const ow_1 = tslib_1.__importDefault(require("ow"));
+const node_crypto_1 = require("node:crypto");
+const input_secrets_1 = require("@apify/input_secrets");
 const consts_1 = require("@apify/consts");
 const timeout_1 = require("@apify/timeout");
 const log_1 = tslib_1.__importDefault(require("@apify/log"));
@@ -15,14 +17,14 @@ const proxy_configuration_1 = require("./proxy_configuration");
 const key_value_store_1 = require("./key_value_store");
 const configuration_1 = require("./configuration");
 /**
- * `Apify` class serves as an alternative approach to the static helpers exported from the package. It allows to pass configuration
+ * `Actor` class serves as an alternative approach to the static helpers exported from the package. It allows to pass configuration
  * that will be used on the instance methods. Environment variables will have precedence over this configuration.
- * See {@link Configuration} for details about what can be configured and what are the default values.
+ * See {@apilink Configuration} for details about what can be configured and what are the default values.
  */
 class Actor {
     constructor(options = {}) {
         /**
-         * Configuration of this SDK instance (provided to its constructor). See {@link Configuration} for details.
+         * Configuration of this SDK instance (provided to its constructor). See {@apilink Configuration} for details.
          * @internal
          */
         Object.defineProperty(this, "config", {
@@ -32,7 +34,7 @@ class Actor {
             value: void 0
         });
         /**
-         * Default {@link ApifyClient} instance.
+         * Default {@apilink ApifyClient} instance.
          * @internal
          */
         Object.defineProperty(this, "apifyClient", {
@@ -42,7 +44,7 @@ class Actor {
             value: void 0
         });
         /**
-         * Default {@link EventManager} instance.
+         * Default {@apilink EventManager} instance.
          * @internal
          */
         Object.defineProperty(this, "eventManager", {
@@ -73,7 +75,7 @@ class Actor {
      * - When running on the Apify platform (i.e. `APIFY_IS_AT_HOME` environment variable is set),
      *   it sets up a connection to listen for platform events.
      *   For example, to get a notification about an imminent migration to another server.
-     *   See {@link Actor.events} for details.
+     *   See {@apilink Actor.events} for details.
      * - It checks that either `APIFY_TOKEN` or `APIFY_LOCAL_STORAGE_DIR` environment variable
      *   is defined. If not, the functions sets `APIFY_LOCAL_STORAGE_DIR` to `./apify_storage`
      *   inside the current working directory. This is to simplify running code examples.
@@ -147,7 +149,6 @@ class Actor {
         (0, utils_2.printOutdatedSdkWarning)();
         // reset global config instance to respect APIFY_ prefixed env vars
         core_1.Configuration.globalConfig = configuration_1.Configuration.getGlobalConfig();
-        await this.eventManager.init();
         if (this.isAtHome()) {
             this.config.set('availableMemoryRatio', 1);
             this.config.set('disableBrowserSandbox', true); // for browser launcher, adds `--no-sandbox` to args
@@ -157,6 +158,8 @@ class Actor {
         else if (options.storage) {
             this.config.useStorageClient(options.storage);
         }
+        // Init the event manager the config uses
+        await this.config.getEventManager().init();
         await (0, core_1.purgeDefaultStorages)(this.config);
         configuration_1.Configuration.storage.enterWith(this.config);
     }
@@ -169,12 +172,12 @@ class Actor {
         options.exitCode ?? (options.exitCode = exports.EXIT_CODES.SUCCESS);
         options.timeoutSecs ?? (options.timeoutSecs = 30);
         // Close the event manager and emit the final PERSIST_STATE event
-        await this.eventManager.close();
+        await this.config.getEventManager().close();
         // Emit the exit event
-        this.eventManager.emit("exit" /* EventType.EXIT */, options);
+        this.config.getEventManager().emit("exit" /* EventType.EXIT */, options);
         // Wait for all event listeners to be processed
         log_1.default.debug(`Waiting for all event listeners to complete their execution (with ${options.timeoutSecs} seconds timeout)`);
-        await (0, timeout_1.addTimeoutToPromise)(() => this.eventManager.waitForAllListenersToComplete(), options.timeoutSecs * 1000, `Waiting for all event listeners to complete their execution timed out after ${options.timeoutSecs} seconds`);
+        await (0, timeout_1.addTimeoutToPromise)(() => this.config.getEventManager().waitForAllListenersToComplete(), options.timeoutSecs * 1000, `Waiting for all event listeners to complete their execution timed out after ${options.timeoutSecs} seconds`);
         const client = this.config.getStorageClient();
         if (client.teardown) {
             let finished = false;
@@ -209,41 +212,29 @@ class Actor {
      * @ignore
      */
     on(event, listener) {
-        this.eventManager.on(event, listener);
+        this.config.getEventManager().on(event, listener);
     }
     /**
      * @ignore
      */
     off(event, listener) {
-        this.eventManager.off(event, listener);
+        this.config.getEventManager().off(event, listener);
     }
     /**
-     * Runs an actor on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable),
-     * waits for the actor to finish and fetches its output.
-     *
-     * By passing the `waitSecs` option you can reduce the maximum amount of time to wait for the run to finish.
-     * If the value is less than or equal to zero, the function returns immediately after the run is started.
+     * Runs an actor on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable).
      *
-     * The result of the function is an {@link ActorRun} object
-     * that contains details about the actor run and its output (if any).
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
-     * If you want to run an actor task rather than an actor, please use the
-     * {@link Actor.callTask} function instead.
+     * If you want to run an actor task rather than an actor, please use the {@apilink Actor.callTask} function instead.
      *
-     * For more information about actors, read the
-     * [documentation](https://docs.apify.com/actor).
+     * For more information about actors, read the [documentation](https://docs.apify.com/actor).
      *
      * **Example usage:**
      *
      * ```javascript
      * const run = await Actor.call('apify/hello-world', { myInput: 123 });
-     * console.log(`Received message: ${run.output.body.message}`);
      * ```
      *
-     * Internally, the `call()` function invokes the
-     * [Run actor](https://apify.com/docs/api/v2#/reference/actors/run-collection/run-actor)
-     * and several other API endpoints to obtain the output.
-     *
      * @param actorId
      *  Allowed formats are `username/actor-name`, `userId/actor-name` or actor ID.
      * @param [input]
@@ -262,7 +253,7 @@ class Actor {
      * Runs an actor on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable),
      * unlike `Actor.call`, this method just starts the run without waiting for finish.
      *
-     * The result of the function is an {@link ActorRun} object that contains details about the actor run.
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
      * For more information about actors, read the
      * [documentation](https://docs.apify.com/actor).
@@ -290,7 +281,7 @@ class Actor {
     /**
      * Aborts given actor run on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable).
      *
-     * The result of the function is an {@link ActorRun} object that contains details about the actor run.
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
      * For more information about actors, read the
      * [documentation](https://docs.apify.com/actor).
@@ -308,18 +299,13 @@ class Actor {
         return client.run(runId).abort(rest);
     }
     /**
-     * Runs an actor task on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable),
-     * waits for the task to finish and fetches its output.
-     *
-     * By passing the `waitSecs` option you can reduce the maximum amount of time to wait for the run to finish.
-     * If the value is less than or equal to zero, the function returns immediately after the run is started.
+     * Runs an actor task on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable).
      *
-     * The result of the function is an {@link ActorRun} object
-     * that contains details about the actor run and its output (if any).
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
      * Note that an actor task is a saved input configuration and options for an actor.
      * If you want to run an actor directly rather than an actor task, please use the
-     * {@link Actor.call} function instead.
+     * {@apilink Actor.call} function instead.
      *
      * For more information about actor tasks, read the [documentation](https://docs.apify.com/tasks).
      *
@@ -327,13 +313,8 @@ class Actor {
      *
      * ```javascript
      * const run = await Actor.callTask('bob/some-task');
-     * console.log(`Received message: ${run.output.body.message}`);
      * ```
      *
-     * Internally, the `callTask()` function calls the
-     * [Run task](https://apify.com/docs/api/v2#/reference/actor-tasks/run-collection/run-task)
-     * and several other API endpoints to obtain the output.
-     *
      * @param taskId
      *  Allowed formats are `username/task-name`, `userId/task-name` or task ID.
      * @param [input]
@@ -450,9 +431,9 @@ class Actor {
         return this.apifyClient.run(runId).update({ statusMessage });
     }
     /**
-     * Stores an object or an array of objects to the default {@link Dataset} of the current actor run.
+     * Stores an object or an array of objects to the default {@apilink Dataset} of the current actor run.
      *
-     * This is just a convenient shortcut for {@link Dataset.pushData}.
+     * This is just a convenient shortcut for {@apilink Dataset.pushData}.
      * For example, calling the following code:
      * ```javascript
      * await Actor.pushData({ myValue: 123 });
@@ -464,7 +445,7 @@ class Actor {
      * await dataset.pushData({ myValue: 123 });
      * ```
      *
-     * For more information, see {@link Actor.openDataset} and {@link Dataset.pushData}
+     * For more information, see {@apilink Actor.openDataset} and {@apilink Dataset.pushData}
      *
      * **IMPORTANT**: Make sure to use the `await` keyword when calling `pushData()`,
      * otherwise the actor process might finish before the data are stored!
@@ -478,13 +459,13 @@ class Actor {
         return dataset.pushData(item);
     }
     /**
-     * Opens a dataset and returns a promise resolving to an instance of the {@link Dataset} class.
+     * Opens a dataset and returns a promise resolving to an instance of the {@apilink Dataset} class.
      *
      * Datasets are used to store structured data where each object stored has the same attributes,
      * such as online store products or real estate offers.
      * The actual data is stored either on the local filesystem or in the cloud.
      *
-     * For more details and code examples, see the {@link Dataset} class.
+     * For more details and code examples, see the {@apilink Dataset} class.
      *
      * @param [datasetIdOrName]
      *   ID or name of the dataset to be opened. If `null` or `undefined`,
@@ -500,9 +481,9 @@ class Actor {
         return this._openStorage(core_1.Dataset, datasetIdOrName, options);
     }
     /**
-     * Gets a value from the default {@link KeyValueStore} associated with the current actor run.
+     * Gets a value from the default {@apilink KeyValueStore} associated with the current actor run.
      *
-     * This is just a convenient shortcut for {@link KeyValueStore.getValue}.
+     * This is just a convenient shortcut for {@apilink KeyValueStore.getValue}.
      * For example, calling the following code:
      * ```javascript
      * const value = await Actor.getValue('my-key');
@@ -514,10 +495,10 @@ class Actor {
      * const value = await store.getValue('my-key');
      * ```
      *
-     * To store the value to the default key-value store, you can use the {@link Actor.setValue} function.
+     * To store the value to the default key-value store, you can use the {@apilink Actor.setValue} function.
      *
-     * For more information, see  {@link Actor.openKeyValueStore}
-     * and  {@link KeyValueStore.getValue}.
+     * For more information, see  {@apilink Actor.openKeyValueStore}
+     * and  {@apilink KeyValueStore.getValue}.
      *
      * @param key Unique record key.
      * @returns
@@ -532,9 +513,9 @@ class Actor {
         return store.getValue(key);
     }
     /**
-     * Stores or deletes a value in the default {@link KeyValueStore} associated with the current actor run.
+     * Stores or deletes a value in the default {@apilink KeyValueStore} associated with the current actor run.
      *
-     * This is just a convenient shortcut for  {@link KeyValueStore.setValue}.
+     * This is just a convenient shortcut for  {@apilink KeyValueStore.setValue}.
      * For example, calling the following code:
      * ```javascript
      * await Actor.setValue('OUTPUT', { foo: "bar" });
@@ -546,10 +527,10 @@ class Actor {
      * await store.setValue('OUTPUT', { foo: "bar" });
      * ```
      *
-     * To get a value from the default key-value store, you can use the  {@link Actor.getValue} function.
+     * To get a value from the default key-value store, you can use the  {@apilink Actor.getValue} function.
      *
-     * For more information, see  {@link Actor.openKeyValueStore}
-     * and  {@link KeyValueStore.getValue}.
+     * For more information, see  {@apilink Actor.openKeyValueStore}
+     * and  {@apilink KeyValueStore.getValue}.
      *
      * @param key
      *   Unique record key.
@@ -567,7 +548,7 @@ class Actor {
         return store.setValue(key, value, options);
     }
     /**
-     * Gets the actor input value from the default {@link KeyValueStore} associated with the current actor run.
+     * Gets the actor input value from the default {@apilink KeyValueStore} associated with the current actor run.
      *
      * This is just a convenient shortcut for [`keyValueStore.getValue('INPUT')`](core/class/KeyValueStore#getValue).
      * For example, calling the following code:
@@ -585,8 +566,8 @@ class Actor {
      * If you need to use the input multiple times in your actor,
      * it is far more efficient to read it once and store it locally.
      *
-     * For more information, see  {@link Actor.openKeyValueStore}
-     * and {@link KeyValueStore.getValue}.
+     * For more information, see  {@apilink Actor.openKeyValueStore}
+     * and {@apilink KeyValueStore.getValue}.
      *
      * @returns
      *   Returns a promise that resolves to an object, string
@@ -596,16 +577,26 @@ class Actor {
      * @ignore
      */
     async getInput() {
-        return this.getValue(this.config.get('inputKey'));
+        const inputSecretsPrivateKeyFile = this.config.get('inputSecretsPrivateKeyFile');
+        const inputSecretsPrivateKeyPassphrase = this.config.get('inputSecretsPrivateKeyPassphrase');
+        const input = await this.getValue(this.config.get('inputKey'));
+        if (ow_1.default.isValid(input, ow_1.default.object.nonEmpty) && inputSecretsPrivateKeyFile && inputSecretsPrivateKeyPassphrase) {
+            const privateKey = (0, node_crypto_1.createPrivateKey)({
+                key: Buffer.from(inputSecretsPrivateKeyFile, 'base64'),
+                passphrase: inputSecretsPrivateKeyPassphrase,
+            });
+            return (0, input_secrets_1.decryptInputSecrets)({ input, privateKey });
+        }
+        return input;
     }
     /**
-     * Opens a key-value store and returns a promise resolving to an instance of the {@link KeyValueStore} class.
+     * Opens a key-value store and returns a promise resolving to an instance of the {@apilink KeyValueStore} class.
      *
      * Key-value stores are used to store records or files, along with their MIME content type.
      * The records are stored and retrieved using a unique key.
      * The actual data is stored either on a local filesystem or in the Apify cloud.
      *
-     * For more details and code examples, see the {@link KeyValueStore} class.
+     * For more details and code examples, see the {@apilink KeyValueStore} class.
      *
      * @param [storeIdOrName]
      *   ID or name of the key-value store to be opened. If `null` or `undefined`,
@@ -622,14 +613,14 @@ class Actor {
     }
     /**
      * Opens a request queue and returns a promise resolving to an instance
-     * of the {@link RequestQueue} class.
+     * of the {@apilink RequestQueue} class.
      *
-     * {@link RequestQueue} represents a queue of URLs to crawl, which is stored either on local filesystem or in the cloud.
+     * {@apilink RequestQueue} represents a queue of URLs to crawl, which is stored either on local filesystem or in the cloud.
      * The queue is used for deep crawling of websites, where you start with several URLs and then
      * recursively follow links to other pages. The data structure supports both breadth-first
      * and depth-first crawling orders.
      *
-     * For more details and code examples, see the {@link RequestQueue} class.
+     * For more details and code examples, see the {@apilink RequestQueue} class.
      *
      * @param [queueIdOrName]
      *   ID or name of the request queue to be opened. If `null` or `undefined`,
@@ -646,13 +637,13 @@ class Actor {
     }
     /**
      * Creates a proxy configuration and returns a promise resolving to an instance
-     * of the {@link ProxyConfiguration} class that is already initialized.
+     * of the {@apilink ProxyConfiguration} class that is already initialized.
      *
      * Configures connection to a proxy server with the provided options. Proxy servers are used to prevent target websites from blocking
      * your crawlers based on IP address rate limits or blacklists. Setting proxy configuration in your crawlers automatically configures
      * them to use the selected proxies for all connections.
      *
-     * For more details and code examples, see the {@link ProxyConfiguration} class.
+     * For more details and code examples, see the {@apilink ProxyConfiguration} class.
      *
      * ```javascript
      *
@@ -694,7 +685,7 @@ class Actor {
         return proxyConfiguration;
     }
     /**
-     * Returns a new {@link ApifyEnv} object which contains information parsed from all the `APIFY_XXX` environment variables.
+     * Returns a new {@apilink ApifyEnv} object which contains information parsed from all the `APIFY_XXX` environment variables.
      *
      * For the list of the `APIFY_XXX` environment variables, see
      * [Actor documentation](https://docs.apify.com/actor/run#environment-variables).
@@ -744,6 +735,31 @@ class Actor {
     isAtHome() {
         return !!process.env[consts_1.ENV_VARS.IS_AT_HOME];
     }
+    /**
+     * Easily create and manage state values. All state values are automatically persisted.
+     *
+     * Values can be modified by simply using the assignment operator.
+     *
+     * @param name The name of the store to use.
+     * @param defaultValue If the store does not yet have a value in it, the value will be initialized with the `defaultValue` you provide.
+     * @param options An optional object parameter where a custom `keyValueStoreName` and `config` can be passed in.
+     */
+    async useState(name, defaultValue = {}, options) {
+        const kvStore = await key_value_store_1.KeyValueStore.open(options?.keyValueStoreName, { config: options?.config || configuration_1.Configuration.getGlobalConfig() });
+        return kvStore.getAutoSavedValue(name || 'APIFY_GLOBAL_STATE', defaultValue);
+    }
+    /**
+     * Easily create and manage state values. All state values are automatically persisted.
+     *
+     * Values can be modified by simply using the assignment operator.
+     *
+     * @param name The name of the store to use.
+     * @param defaultValue If the store does not yet have a value in it, the value will be initialized with the `defaultValue` you provide.
+     * @param options An optional object parameter where a custom `keyValueStoreName` and `config` can be passed in.
+     */
+    static async useState(name, defaultValue = {}, options) {
+        return Actor.getDefaultInstance().useState(name, defaultValue, options);
+    }
     /**
      * Runs the main user function that performs the job of the actor
      * and terminates the process when the user function finishes.
@@ -761,7 +777,7 @@ class Actor {
      * - When running on the Apify platform (i.e. `APIFY_IS_AT_HOME` environment variable is set),
      *   it sets up a connection to listen for platform events.
      *   For example, to get a notification about an imminent migration to another server.
-     *   See {@link Actor.events} for details.
+     *   See {@apilink Actor.events} for details.
      * - It checks that either `APIFY_TOKEN` or `APIFY_LOCAL_STORAGE_DIR` environment variable
      *   is defined. If not, the functions sets `APIFY_LOCAL_STORAGE_DIR` to `./apify_storage`
      *   inside the current working directory. This is to simplify running code examples.
@@ -827,32 +843,20 @@ class Actor {
         Actor.getDefaultInstance().off(event, listener);
     }
     /**
-     * Runs an actor on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable),
-     * waits for the actor to finish and fetches its output.
+     * Runs an actor on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable).
      *
-     * By passing the `waitSecs` option you can reduce the maximum amount of time to wait for the run to finish.
-     * If the value is less than or equal to zero, the function returns immediately after the run is started.
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
-     * The result of the function is an {@link ActorRun} object
-     * that contains details about the actor run and its output (if any).
+     * If you want to run an actor task rather than an actor, please use the {@apilink Actor.callTask} function instead.
      *
-     * If you want to run an actor task rather than an actor, please use the
-     * {@link Actor.callTask} function instead.
-     *
-     * For more information about actors, read the
-     * [documentation](https://docs.apify.com/actor).
+     * For more information about actors, read the [documentation](https://docs.apify.com/actor).
      *
      * **Example usage:**
      *
      * ```javascript
      * const run = await Actor.call('apify/hello-world', { myInput: 123 });
-     * console.log(`Received message: ${run.output.body.message}`);
      * ```
      *
-     * Internally, the `call()` function invokes the
-     * [Run actor](https://apify.com/docs/api/v2#/reference/actors/run-collection/run-actor)
-     * and several other API endpoints to obtain the output.
-     *
      * @param actorId
      *  Allowed formats are `username/actor-name`, `userId/actor-name` or actor ID.
      * @param [input]
@@ -865,18 +869,13 @@ class Actor {
         return Actor.getDefaultInstance().call(actorId, input, options);
     }
     /**
-     * Runs an actor task on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable),
-     * waits for the task to finish and fetches its output.
-     *
-     * By passing the `waitSecs` option you can reduce the maximum amount of time to wait for the run to finish.
-     * If the value is less than or equal to zero, the function returns immediately after the run is started.
+     * Runs an actor task on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable).
      *
-     * The result of the function is an {@link ActorRun} object
-     * that contains details about the actor run and its output (if any).
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
      * Note that an actor task is a saved input configuration and options for an actor.
      * If you want to run an actor directly rather than an actor task, please use the
-     * {@link Actor.call} function instead.
+     * {@apilink Actor.call} function instead.
      *
      * For more information about actor tasks, read the [documentation](https://docs.apify.com/tasks).
      *
@@ -884,13 +883,8 @@ class Actor {
      *
      * ```javascript
      * const run = await Actor.callTask('bob/some-task');
-     * console.log(`Received message: ${run.output.body.message}`);
      * ```
      *
-     * Internally, the `callTask()` function calls the
-     * [Run task](https://apify.com/docs/api/v2#/reference/actor-tasks/run-collection/run-task)
-     * and several other API endpoints to obtain the output.
-     *
      * @param taskId
      *  Allowed formats are `username/task-name`, `userId/task-name` or task ID.
      * @param [input]
@@ -906,7 +900,7 @@ class Actor {
      * Runs an actor on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable),
      * unlike `Actor.call`, this method just starts the run without waiting for finish.
      *
-     * The result of the function is an {@link ActorRun} object that contains details about the actor run.
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
      * For more information about actors, read the
      * [documentation](https://docs.apify.com/actor).
@@ -931,7 +925,7 @@ class Actor {
     /**
      * Aborts given actor run on the Apify platform using the current user account (determined by the `APIFY_TOKEN` environment variable).
      *
-     * The result of the function is an {@link ActorRun} object that contains details about the actor run.
+     * The result of the function is an {@apilink ActorRun} object that contains details about the actor run.
      *
      * For more information about actors, read the
      * [documentation](https://docs.apify.com/actor).
@@ -993,9 +987,9 @@ class Actor {
         return Actor.getDefaultInstance().setStatusMessage(statusMessage);
     }
     /**
-     * Stores an object or an array of objects to the default {@link Dataset} of the current actor run.
+     * Stores an object or an array of objects to the default {@apilink Dataset} of the current actor run.
      *
-     * This is just a convenient shortcut for {@link Dataset.pushData}.
+     * This is just a convenient shortcut for {@apilink Dataset.pushData}.
      * For example, calling the following code:
      * ```javascript
      * await Actor.pushData({ myValue: 123 });
@@ -1007,7 +1001,7 @@ class Actor {
      * await dataset.pushData({ myValue: 123 });
      * ```
      *
-     * For more information, see {@link Actor.openDataset} and {@link Dataset.pushData}
+     * For more information, see {@apilink Actor.openDataset} and {@apilink Dataset.pushData}
      *
      * **IMPORTANT**: Make sure to use the `await` keyword when calling `pushData()`,
      * otherwise the actor process might finish before the data are stored!
@@ -1019,13 +1013,13 @@ class Actor {
         return Actor.getDefaultInstance().pushData(item);
     }
     /**
-     * Opens a dataset and returns a promise resolving to an instance of the {@link Dataset} class.
+     * Opens a dataset and returns a promise resolving to an instance of the {@apilink Dataset} class.
      *
      * Datasets are used to store structured data where each object stored has the same attributes,
      * such as online store products or real estate offers.
      * The actual data is stored either on the local filesystem or in the cloud.
      *
-     * For more details and code examples, see the {@link Dataset} class.
+     * For more details and code examples, see the {@apilink Dataset} class.
      *
      * @param [datasetIdOrName]
      *   ID or name of the dataset to be opened. If `null` or `undefined`,
@@ -1036,9 +1030,9 @@ class Actor {
         return Actor.getDefaultInstance().openDataset(datasetIdOrName, options);
     }
     /**
-     * Gets a value from the default {@link KeyValueStore} associated with the current actor run.
+     * Gets a value from the default {@apilink KeyValueStore} associated with the current actor run.
      *
-     * This is just a convenient shortcut for {@link KeyValueStore.getValue}.
+     * This is just a convenient shortcut for {@apilink KeyValueStore.getValue}.
      * For example, calling the following code:
      * ```javascript
      * const value = await Actor.getValue('my-key');
@@ -1050,10 +1044,10 @@ class Actor {
      * const value = await store.getValue('my-key');
      * ```
      *
-     * To store the value to the default key-value store, you can use the {@link Actor.setValue} function.
+     * To store the value to the default key-value store, you can use the {@apilink Actor.setValue} function.
      *
-     * For more information, see  {@link Actor.openKeyValueStore}
-     * and  {@link KeyValueStore.getValue}.
+     * For more information, see  {@apilink Actor.openKeyValueStore}
+     * and  {@apilink KeyValueStore.getValue}.
      *
      * @param key Unique record key.
      * @returns
@@ -1066,9 +1060,9 @@ class Actor {
         return Actor.getDefaultInstance().getValue(key);
     }
     /**
-     * Stores or deletes a value in the default {@link KeyValueStore} associated with the current actor run.
+     * Stores or deletes a value in the default {@apilink KeyValueStore} associated with the current actor run.
      *
-     * This is just a convenient shortcut for  {@link KeyValueStore.setValue}.
+     * This is just a convenient shortcut for  {@apilink KeyValueStore.setValue}.
      * For example, calling the following code:
      * ```javascript
      * await Actor.setValue('OUTPUT', { foo: "bar" });
@@ -1080,10 +1074,10 @@ class Actor {
      * await store.setValue('OUTPUT', { foo: "bar" });
      * ```
      *
-     * To get a value from the default key-value store, you can use the  {@link Actor.getValue} function.
+     * To get a value from the default key-value store, you can use the  {@apilink Actor.getValue} function.
      *
-     * For more information, see  {@link Actor.openKeyValueStore}
-     * and  {@link KeyValueStore.getValue}.
+     * For more information, see  {@apilink Actor.openKeyValueStore}
+     * and  {@apilink KeyValueStore.getValue}.
      *
      * @param key
      *   Unique record key.
@@ -1099,9 +1093,9 @@ class Actor {
         return Actor.getDefaultInstance().setValue(key, value, options);
     }
     /**
-     * Gets the actor input value from the default {@link KeyValueStore} associated with the current actor run.
+     * Gets the actor input value from the default {@apilink KeyValueStore} associated with the current actor run.
      *
-     * This is just a convenient shortcut for {@link KeyValueStore.getValue | `keyValueStore.getValue('INPUT')`}.
+     * This is just a convenient shortcut for {@apilink KeyValueStore.getValue | `keyValueStore.getValue('INPUT')`}.
      * For example, calling the following code:
      * ```javascript
      * const input = await Actor.getInput();
@@ -1117,7 +1111,7 @@ class Actor {
      * If you need to use the input multiple times in your actor,
      * it is far more efficient to read it once and store it locally.
      *
-     * For more information, see {@link Actor.openKeyValueStore} and {@link KeyValueStore.getValue}.
+     * For more information, see {@apilink Actor.openKeyValueStore} and {@apilink KeyValueStore.getValue}.
      *
      * @returns
      *   Returns a promise that resolves to an object, string
@@ -1129,13 +1123,13 @@ class Actor {
         return Actor.getDefaultInstance().getInput();
     }
     /**
-     * Opens a key-value store and returns a promise resolving to an instance of the {@link KeyValueStore} class.
+     * Opens a key-value store and returns a promise resolving to an instance of the {@apilink KeyValueStore} class.
      *
      * Key-value stores are used to store records or files, along with their MIME content type.
      * The records are stored and retrieved using a unique key.
      * The actual data is stored either on a local filesystem or in the Apify cloud.
      *
-     * For more details and code examples, see the {@link KeyValueStore} class.
+     * For more details and code examples, see the {@apilink KeyValueStore} class.
      *
      * @param [storeIdOrName]
      *   ID or name of the key-value store to be opened. If `null` or `undefined`,
@@ -1147,14 +1141,14 @@ class Actor {
     }
     /**
      * Opens a request queue and returns a promise resolving to an instance
-     * of the {@link RequestQueue} class.
+     * of the {@apilink RequestQueue} class.
      *
-     * {@link RequestQueue} represents a queue of URLs to crawl, which is stored either on local filesystem or in the cloud.
+     * {@apilink RequestQueue} represents a queue of URLs to crawl, which is stored either on local filesystem or in the cloud.
      * The queue is used for deep crawling of websites, where you start with several URLs and then
      * recursively follow links to other pages. The data structure supports both breadth-first
      * and depth-first crawling orders.
      *
-     * For more details and code examples, see the {@link RequestQueue} class.
+     * For more details and code examples, see the {@apilink RequestQueue} class.
      *
      * @param [queueIdOrName]
      *   ID or name of the request queue to be opened. If `null` or `undefined`,
@@ -1166,13 +1160,13 @@ class Actor {
     }
     /**
      * Creates a proxy configuration and returns a promise resolving to an instance
-     * of the {@link ProxyConfiguration} class that is already initialized.
+     * of the {@apilink ProxyConfiguration} class that is already initialized.
      *
      * Configures connection to a proxy server with the provided options. Proxy servers are used to prevent target websites from blocking
      * your crawlers based on IP address rate limits or blacklists. Setting proxy configuration in your crawlers automatically configures
      * them to use the selected proxies for all connections.
      *
-     * For more details and code examples, see the {@link ProxyConfiguration} class.
+     * For more details and code examples, see the {@apilink ProxyConfiguration} class.
      *
      * ```javascript
      *
@@ -1203,7 +1197,7 @@ class Actor {
         return Actor.getDefaultInstance().createProxyConfiguration(proxyConfigurationOptions);
     }
     /**
-     * Returns a new {@link ApifyEnv} object which contains information parsed from all the `APIFY_XXX` environment variables.
+     * Returns a new {@apilink ApifyEnv} object which contains information parsed from all the `APIFY_XXX` environment variables.
      *
      * For the list of the `APIFY_XXX` environment variables, see
      * [Actor documentation](https://docs.apify.com/actor/run#environment-variables).
@@ -1228,11 +1222,11 @@ class Actor {
     static isAtHome() {
         return Actor.getDefaultInstance().isAtHome();
     }
-    /** Default {@link ApifyClient} instance. */
+    /** Default {@apilink ApifyClient} instance. */
     static get apifyClient() {
         return Actor.getDefaultInstance().apifyClient;
     }
-    /** Default {@link Configuration} instance. */
+    /** Default {@apilink Configuration} instance. */
     static get config() {
         return Actor.getDefaultInstance().config;
     }