apify-client 2.20.1-beta.6 → 2.20.1-beta.8

package/dist/bundle.js

@@ -56411,8 +56411,25 @@ __webpack_require__.d(__webpack_exports__, {
 
 const DEFAULT_TIMEOUT_SECS = 360;
 /**
- * ApifyClient is the official library to access [Apify API](https://docs.apify.com/api/v2) from your
- * JavaScript applications. It runs both in Node.js and browser.
+ * The official JavaScript client for the Apify API.
+ *
+ * Provides programmatic access to all Apify platform resources including Actors, runs, datasets,
+ * key-value stores, request queues, and more. Works in both Node.js and browser environments.
+ *
+ * @example
+ * ```javascript
+ * import { ApifyClient } from 'apify-client';
+ *
+ * const client = new ApifyClient({ token: 'my-token' });
+ *
+ * // Start an Actor and wait for it to finish
+ * const run = await client.actor('my-actor-id').call();
+ *
+ * // Fetch dataset items
+ * const { items } = await client.dataset(run.defaultDatasetId).listItems();
+ * ```
+ *
+ * @see https://docs.apify.com/api/v2
  */ class ApifyClient {
     _options() {
         return {
@@ -56423,12 +56440,30 @@ const DEFAULT_TIMEOUT_SECS = 360;
         };
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/actor-collection
+     * Returns a client for managing Actors in your account.
+     *
+     * Provides access to the Actor collection, allowing you to list, create, and search for Actors.
+     *
+     * @returns A client for the Actors collection
+     * @see https://docs.apify.com/api/v2/acts-get
      */ actors() {
         return new _resource_clients_actor_collection__rspack_import_4.ActorCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/actor-object
+     * Returns a client for a specific Actor.
+     *
+     * Use this to get, update, delete, start, or call an Actor, as well as manage its builds,
+     * runs, versions, and webhooks.
+     *
+     * @param id - Actor ID or username/name
+     * @returns A client for the specific Actor
+     * @see https://docs.apify.com/api/v2/act-get
+     *
+     * @example
+     * ```javascript
+     * // Call an Actor and wait for it to finish
+     * const run = await client.actor('apify/web-scraper').call({ url: 'https://example.com' });
+     * ```
      */ actor(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_actor__rspack_import_3.ActorClient({
@@ -56437,12 +56472,23 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-builds/build-collection
+     * Returns a client for managing Actor builds in your account.
+     *
+     * Lists all builds across all of your Actors.
+     *
+     * @returns A client for Actor builds collection
+     * @see https://docs.apify.com/api/v2/actor-builds-get
      */ builds() {
         return new _resource_clients_build_collection__rspack_import_6.BuildCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-builds/build-object
+     * Returns a client for a specific Actor build.
+     *
+     * Use this to get details about a build, wait for it to finish, or access its logs.
+     *
+     * @param id - Build ID
+     * @returns A client for the specified build
+     * @see https://docs.apify.com/api/v2/actor-build-get
      */ build(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_build__rspack_import_5.BuildClient({
@@ -56451,12 +56497,37 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/dataset-collection
+     * Returns a client for managing datasets in your account.
+     *
+     * Datasets store structured data results from Actor runs. Use this to list or create datasets.
+     *
+     * @returns A client for the Datasets collection
+     * @see https://docs.apify.com/api/v2/datasets-get
      */ datasets() {
         return new _resource_clients_dataset_collection__rspack_import_8.DatasetCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/dataset
+     * Returns a client for a specific dataset.
+     *
+     * Use this to read, write, and manage items in the dataset. Datasets contain structured
+     * data stored as individual items (records).
+     *
+     * @template Data - Type of items stored in the dataset
+     * @param id - Dataset ID or name
+     * @returns A client for the specific Dataset
+     * @see https://docs.apify.com/api/v2/dataset-get
+     *
+     * @example
+     * ```javascript
+     * // Push items to a dataset
+     * await client.dataset('my-dataset').pushItems([
+     *   { url: 'https://example.com', title: 'Example' },
+     *   { url: 'https://test.com', title: 'Test' }
+     * ]);
+     *
+     * // Retrieve items
+     * const { items } = await client.dataset('my-dataset').listItems();
+     * ```
      */ dataset(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_dataset__rspack_import_7.DatasetClient({
@@ -56465,12 +56536,33 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/store-collection
+     * Returns a client for managing key-value stores in your account.
+     *
+     * Key-value stores are used to store arbitrary data records or files.
+     *
+     * @returns A client for the Key-value stores collection
+     * @see https://docs.apify.com/api/v2/key-value-stores-get
      */ keyValueStores() {
         return new _resource_clients_key_value_store_collection__rspack_import_10.KeyValueStoreCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/store-object
+     * Returns a client for a specific key-value store.
+     *
+     * Use this to read, write, and delete records in the store. Key-value stores can hold
+     * any type of data including text, JSON, images, and other files.
+     *
+     * @param id - Key-value store ID or name
+     * @returns A client for the specific key-value store
+     * @see https://docs.apify.com/api/v2/key-value-store-get
+     *
+     * @example
+     * ```javascript
+     * // Save a record
+     * await client.keyValueStore('my-store').setRecord({ key: 'OUTPUT', value: { foo: 'bar' } });
+     *
+     * // Get a record
+     * const record = await client.keyValueStore('my-store').getRecord('OUTPUT');
+     * ```
      */ keyValueStore(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_key_value_store__rspack_import_9.KeyValueStoreClient({
@@ -56479,7 +56571,11 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/logs
+     * Returns a client for accessing logs of an Actor build or run.
+     *
+     * @param buildOrRunId - Build ID or run ID
+     * @returns A client for accessing logs
+     * @see https://docs.apify.com/api/v2/log-get
      */ log(buildOrRunId) {
         ow__rspack_import_27_default()(buildOrRunId, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_log__rspack_import_11.LogClient({
@@ -56488,12 +56584,35 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue-collection
+     * Returns a client for managing request queues in your account.
+     *
+     * Request queues store URLs to be crawled, along with their metadata.
+     *
+     * @returns A client for the Request queues collection
+     * @see https://docs.apify.com/api/v2/request-queues-get
      */ requestQueues() {
         return new _resource_clients_request_queue_collection__rspack_import_13.RequestQueueCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue
+     * Returns a client for a specific request queue.
+     *
+     * Use this to add, retrieve, and manage requests in the queue. Request queues are used
+     * by web crawlers to manage URLs that need to be visited.
+     *
+     * @param id - Request queue ID or name
+     * @param options - Configuration options for the request queue client
+     * @returns A client for the specific Request queue
+     * @see https://docs.apify.com/api/v2/request-queue-get
+     *
+     * @example
+     * ```javascript
+     * // Add requests to a queue
+     * const queue = client.requestQueue('my-queue');
+     * await queue.addRequest({ url: 'https://example.com', uniqueKey: 'example' });
+     *
+     * // Get and lock the next request
+     * const { items } = await queue.listAndLockHead({ lockSecs: 60 });
+     * ```
      */ requestQueue(id) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
@@ -56508,7 +56627,12 @@ const DEFAULT_TIMEOUT_SECS = 360;
         return new _resource_clients_request_queue__rspack_import_12.RequestQueueClient(apiClientOptions, options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/run-collection
+     * Returns a client for managing Actor runs in your account.
+     *
+     * Lists all runs across all of your Actors.
+     *
+     * @returns A client for the run collection
+     * @see https://docs.apify.com/api/v2/actor-runs-get
      */ runs() {
         return new _resource_clients_run_collection__rspack_import_15.RunCollectionClient({
             ...this._options(),
@@ -56516,7 +56640,23 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/run-object-and-its-storages
+     * Returns a client for a specific Actor run.
+     *
+     * Use this to get details about a run, wait for it to finish, abort it, or access its
+     * dataset, key-value store, and request queue.
+     *
+     * @param id - Run ID
+     * @returns A client for the specified run
+     * @see https://docs.apify.com/api/v2/actor-run-get
+     *
+     * @example
+     * ```javascript
+     * // Wait for a run to finish
+     * const run = await client.run('run-id').waitForFinish();
+     *
+     * // Access run's dataset
+     * const { items } = await client.run('run-id').dataset().listItems();
+     * ```
      */ run(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_run__rspack_import_14.RunClient({
@@ -56525,12 +56665,29 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-collection
+     * Returns a client for managing Actor tasks in your account.
+     *
+     * Tasks are pre-configured Actor runs with stored input that can be executed repeatedly.
+     *
+     * @returns A client for the task collection
+     * @see https://docs.apify.com/api/v2/actor-tasks-get
      */ tasks() {
         return new _resource_clients_task_collection__rspack_import_20.TaskCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-object
+     * Returns a client for a specific Actor task.
+     *
+     * Use this to get, update, delete, or run a task with pre-configured input.
+     *
+     * @param id - Task ID or username/task-name
+     * @returns A client for the specified task
+     * @see https://docs.apify.com/api/v2/actor-task-get
+     *
+     * @example
+     * ```javascript
+     * // Run a task and wait for it to finish
+     * const run = await client.task('my-task').call();
+     * ```
      */ task(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_task__rspack_import_19.TaskClient({
@@ -56539,12 +56696,23 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedules-collection
+     * Returns a client for managing schedules in your account.
+     *
+     * Schedules automatically start Actor or task runs at specified times.
+     *
+     * @returns A client for the Schedules collection
+     * @see https://docs.apify.com/api/v2/schedules-get
      */ schedules() {
         return new _resource_clients_schedule_collection__rspack_import_17.ScheduleCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedule-object
+     * Returns a client for a specific schedule.
+     *
+     * Use this to get, update, or delete a schedule.
+     *
+     * @param id - Schedule ID
+     * @returns A client for the specific Schedule
+     * @see https://docs.apify.com/api/v2/schedule-get
      */ schedule(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_schedule__rspack_import_16.ScheduleClient({
@@ -56553,7 +56721,13 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/users
+     * Returns a client for accessing user data.
+     *
+     * By default, returns information about the current user (determined by the API token).
+     *
+     * @param id - User ID or username. Defaults to 'me' (current user)
+     * @returns A client for the user
+     * @see https://docs.apify.com/api/v2/user-get
      */ user() {
         let id = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : _apify_consts__rspack_import_0.ME_USER_NAME_PLACEHOLDER;
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
@@ -56563,12 +56737,23 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-collection
+     * Returns a client for managing webhooks in your account.
+     *
+     * Webhooks notify external services when specific events occur (e.g., Actor run finishes).
+     *
+     * @returns A client for the Webhooks collection
+     * @see https://docs.apify.com/api/v2/webhooks-get
      */ webhooks() {
         return new _resource_clients_webhook_collection__rspack_import_23.WebhookCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-object
+     * Returns a client for a specific webhook.
+     *
+     * Use this to get, update, delete, or test a webhook.
+     *
+     * @param id - Webhook ID
+     * @returns A client for the specific webhook
+     * @see https://docs.apify.com/api/v2/webhook-get
      */ webhook(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_webhook__rspack_import_22.WebhookClient({
@@ -56577,12 +56762,21 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhook-dispatches
+     * Returns a client for viewing webhook dispatches in your account.
+     *
+     * Webhook dispatches represent individual invocations of webhooks.
+     *
+     * @returns A client for the webhook dispatches collection
+     * @see https://docs.apify.com/api/v2/webhook-dispatches-get
      */ webhookDispatches() {
         return new _resource_clients_webhook_dispatch_collection__rspack_import_25.WebhookDispatchCollectionClient(this._options());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhook-dispatches/webhook-dispatch-object
+     * Returns a client for a specific webhook dispatch.
+     *
+     * @param id - Webhook dispatch ID
+     * @returns A client for the specific webhook dispatch
+     * @see https://docs.apify.com/api/v2/webhook-dispatch-get
      */ webhookDispatch(id) {
         ow__rspack_import_27_default()(id, (ow__rspack_import_27_default().string.nonEmpty));
         return new _resource_clients_webhook_dispatch__rspack_import_24.WebhookDispatchClient({
@@ -56591,11 +56785,25 @@ const DEFAULT_TIMEOUT_SECS = 360;
         });
     }
     /**
-     * https://docs.apify.com/api/v2/#/reference/store
+     * Returns a client for browsing Actors in Apify Store.
+     *
+     * Use this to search and retrieve information about public Actors.
+     *
+     * @returns A client for the Apify Store
+     * @see https://docs.apify.com/api/v2/store-actors-get
      */ store() {
         return new _resource_clients_store_collection__rspack_import_18.StoreCollectionClient(this._options());
     }
-    async setStatusMessage(message, options) {
+    /**
+     * Sets a status message for the current Actor run.
+     *
+     * This is a convenience method that updates the status message of the run specified by
+     * the `ACTOR_RUN_ID` environment variable. Only works when called from within an Actor run.
+     *
+     * @param message - The status message to set
+     * @param options - Additional options for the status message
+     * @throws {Error} If `ACTOR_RUN_ID` environment variable is not set
+     */ async setStatusMessage(message, options) {
         const runId = process.env[_apify_consts__rspack_import_0.ACTOR_ENV_VARS.RUN_ID];
         if (!runId) {
             throw new Error(`Environment variable ${_apify_consts__rspack_import_0.ACTOR_ENV_VARS.RUN_ID} is not set!`);
@@ -57576,26 +57784,84 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient {
+/**
+ * Client for managing a specific Actor.
+ *
+ * Provides methods to start, call, build, update, and delete an Actor, as well as manage its
+ * versions, builds, runs, and webhooks.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const actorClient = client.actor('my-actor-id');
+ *
+ * // Start an Actor
+ * const run = await actorClient.start(input, { memory: 256 });
+ *
+ * // Call an Actor and wait for it to finish
+ * const finishedRun = await actorClient.call({ url: 'https://example.com' });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors
+ */ class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/actor-object/get-actor
+     * Gets the Actor object from the Apify API.
+     *
+     * @returns The Actor object, or `undefined` if it does not exist
+     * @see https://docs.apify.com/api/v2/act-get
      */ async get() {
         return this._get();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/actor-object/update-actor
+     * Updates the Actor with specified fields.
+     *
+     * @param newFields - Fields to update in the Actor
+     * @returns The updated Actor object
+     * @see https://docs.apify.com/api/v2/act-put
      */ async update(newFields) {
         ow__rspack_import_11_default()(newFields, (ow__rspack_import_11_default().object));
         return this._update(newFields);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/actor-object/delete-actor
+     * Deletes the Actor.
+     *
+     * @see https://docs.apify.com/api/v2/act-delete
      */ async delete() {
         return this._delete();
     }
     /**
-     * Starts an actor and immediately returns the Run object.
-     * https://docs.apify.com/api/v2#/reference/actors/run-collection/run-actor
+     * Starts the Actor and immediately returns the Run object.
+     *
+     * The Actor run can be configured with optional input and various options. The run starts
+     * asynchronously and this method returns immediately without waiting for completion.
+     * Use the {@link call} method if you want to wait for the Actor to finish.
+     *
+     * @param input - Input for the Actor. Can be any JSON-serializable value (object, array, string, number).
+     *                If `contentType` is specified in options, input should be a string or Buffer.
+     * @param options - Run configuration options
+     * @param options.build - Tag or number of the build to run (e.g., `'beta'` or `'1.2.345'`). If not provided, uses the default build.
+     * @param options.memory - Memory in megabytes allocated for the run. If not provided, uses the Actor's default memory setting.
+     * @param options.timeout - Timeout for the run in seconds. Zero means no timeout. If not provided, uses the Actor's default timeout.
+     * @param options.waitForFinish - Maximum time to wait (in seconds, max 60s) for the run to finish on the API side before returning. Default is 0 (returns immediately).
+     * @param options.webhooks - Webhooks to trigger when the Actor run reaches a specific state (e.g., `SUCCEEDED`, `FAILED`).
+     * @param options.maxItems - Maximum number of dataset items that will be charged (only for pay-per-result Actors).
+     * @param options.maxTotalChargeUsd - Maximum cost in USD (only for pay-per-event Actors).
+     * @param options.contentType - Content type of the input. If specified, input must be a string or Buffer.
+     * @returns The Actor run object with status, usage, and storage IDs
+     * @see https://docs.apify.com/api/v2/act-runs-post
+     *
+     * @example
+     * ```javascript
+     * // Start Actor with simple input
+     * const run = await client.actor('my-actor').start({ url: 'https://example.com' });
+     * console.log(`Run started with ID: ${run.id}, status: ${run.status}`);
+     *
+     * // Start Actor with specific build and memory
+     * const run = await client.actor('my-actor').start(
+     *   { url: 'https://example.com' },
+     *   { build: '0.1.2', memory: 512, timeout: 300 }
+     * );
+     * ```
      */ async start(input) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         // input can be anything, so no point in validating it. E.g. if you set content-type to application/pdf
@@ -57645,9 +57911,41 @@ class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * Starts an actor and waits for it to finish before returning the Run object.
-     * It waits indefinitely, unless the `waitSecs` option is provided.
-     * https://docs.apify.com/api/v2#/reference/actors/run-collection/run-actor
+     * Starts the Actor and waits for it to finish before returning the Run object.
+     *
+     * This is a convenience method that starts the Actor run and waits for its completion
+     * by polling the run status. It optionally streams logs to the console or a custom Log instance.
+     * By default, it waits indefinitely unless the `waitSecs` option is provided.
+     *
+     * @param input - Input for the Actor. Can be any JSON-serializable value (object, array, string, number).
+     *                If `contentType` is specified in options, input should be a string or Buffer.
+     * @param options - Run configuration options (extends all options from {@link start})
+     * @param options.waitSecs - Maximum time to wait for the run to finish, in seconds. If omitted, waits indefinitely.
+     * @param options.log - Log instance for streaming run logs. Use `'default'` for console output, `null` to disable logging, or provide a custom Log instance.
+     * @param options.build - Tag or number of the build to run (e.g., `'beta'` or `'1.2.345'`).
+     * @param options.memory - Memory in megabytes allocated for the run.
+     * @param options.timeout - Maximum run duration in seconds.
+     * @returns The finished Actor run object with final status (`SUCCEEDED`, `FAILED`, `ABORTED`, or `TIMED-OUT`)
+     * @see https://docs.apify.com/api/v2/act-runs-post
+     *
+     * @example
+     * ```javascript
+     * // Run an Actor and wait for it to finish
+     * const run = await client.actor('my-actor').call({ url: 'https://example.com' });
+     * console.log(`Run finished with status: ${run.status}`);
+     * console.log(`Dataset ID: ${run.defaultDatasetId}`);
+     *
+     * // Run with a timeout and log streaming to console
+     * const run = await client.actor('my-actor').call(
+     *   { url: 'https://example.com' },
+     *   { waitSecs: 300, log: 'default' }
+     * );
+     *
+     * // Run with custom log instance
+     * import { Log } from '@apify/log';
+     * const log = new Log({ prefix: 'My Actor' });
+     * const run = await client.actor('my-actor').call({ url: 'https://example.com' }, { log });
+     * ```
      */ async call(input) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         // input can be anything, so no point in validating it. E.g. if you set content-type to application/pdf
@@ -57682,8 +57980,33 @@ class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/build-collection/build-actor
-     * @return {Promise<Build>}
+     * Builds the Actor.
+     *
+     * Creates a new build of the specified Actor version. The build compiles the Actor's
+     * source code, installs dependencies, and prepares it for execution.
+     *
+     * @param versionNumber - Version number or tag to build (e.g., `'0.1'`, `'0.2'`, `'latest'`)
+     * @param options - Build configuration options
+     * @param options.betaPackages - If `true`, the build uses beta versions of Apify NPM packages.
+     * @param options.tag - Tag to be applied to the build (e.g., `'latest'`, `'beta'`). Existing tag with the same name will be replaced.
+     * @param options.useCache - If `false`, Docker build cache will be ignored. Default is `true`.
+     * @param options.waitForFinish - Maximum time to wait (in seconds, max 60s) for the build to finish on the API side before returning. Default is 0 (returns immediately).
+     * @returns The Build object with status and build details
+     * @see https://docs.apify.com/api/v2/act-builds-post
+     *
+     * @example
+     * ```javascript
+     * // Start a build and return immediately
+     * const build = await client.actor('my-actor').build('0.1');
+     * console.log(`Build ${build.id} started with status: ${build.status}`);
+     *
+     * // Build and wait up to 120 seconds for it to finish
+     * const build = await client.actor('my-actor').build('0.1', {
+     *   waitForFinish: 120,
+     *   tag: 'latest',
+     *   useCache: true
+     * });
+     * ```
      */ async build(versionNumber) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_11_default()(versionNumber, (ow__rspack_import_11_default().string));
@@ -57704,7 +58027,11 @@ class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2/act-build-default-get
+     * Retrieves the default build of the Actor.
+     *
+     * @param options - Options for getting the build.
+     * @returns A client for the default build.
+     * @see https://docs.apify.com/api/v2/act-build-default-get
      */ async defaultBuild() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         const response = await this.httpClient.call({
@@ -57722,7 +58049,21 @@ class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/last-run-object-and-its-storages
+     * Returns a client for the last run of this Actor.
+     *
+     * Provides access to the most recent Actor run, optionally filtered by status or origin.
+     *
+     * @param options - Options to filter the last run
+     * @param options.status - Filter by run status (e.g., `'SUCCEEDED'`, `'FAILED'`, `'RUNNING'`, `'ABORTED'`, `'TIMED-OUT'`).
+     * @param options.origin - Filter by run origin (e.g., `'DEVELOPMENT'`, `'WEB'`, `'API'`, `'SCHEDULER'`).
+     * @returns A client for the last run
+     * @see https://docs.apify.com/api/v2/act-runs-last-get
+     *
+     * @example
+     * ```javascript
+     * // Get the last successful run
+     * const lastRun = await client.actor('my-actor').lastRun({ status: 'SUCCEEDED' }).get();
+     * ```
      */ lastRun() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_11_default()(options, ow__rspack_import_11_default().object.exactShape({
@@ -57736,21 +58077,31 @@ class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/build-collection
+     * Returns a client for managing builds of this Actor.
+     *
+     * @returns A client for the Actor's build collection
+     * @see https://docs.apify.com/api/v2/act-builds-get
      */ builds() {
         return new _build_collection__rspack_import_7.BuildCollectionClient(this._subResourceOptions({
             resourcePath: 'builds'
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/run-collection
+     * Returns a client for managing runs of this Actor.
+     *
+     * @returns A client for the Actor's run collection
+     * @see https://docs.apify.com/api/v2/act-runs-get
      */ runs() {
         return new _run_collection__rspack_import_9.RunCollectionClient(this._subResourceOptions({
             resourcePath: 'runs'
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/version-object
+     * Returns a client for a specific version of this Actor.
+     *
+     * @param versionNumber - Version number (e.g., '0.1', '1.2.3')
+     * @returns A client for the specified Actor version
+     * @see https://docs.apify.com/api/v2/act-version-get
      */ version(versionNumber) {
         ow__rspack_import_11_default()(versionNumber, (ow__rspack_import_11_default().string));
         return new _actor_version__rspack_import_4.ActorVersionClient(this._subResourceOptions({
@@ -57758,14 +58109,18 @@ class ActorClient extends _base_resource_client__rspack_import_2.ResourceClient
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/version-collection
-     * @return {ActorVersionCollectionClient}
+     * Returns a client for managing versions of this Actor.
+     *
+     * @returns A client for the Actor's version collection
+     * @see https://docs.apify.com/api/v2/act-versions-get
      */ versions() {
         return new _actor_version_collection__rspack_import_5.ActorVersionCollectionClient(this._subResourceOptions());
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/webhook-collection
-     * @return {WebhookCollectionClient}
+     * Returns a client for managing webhooks associated with this Actor.
+     *
+     * @returns A client for the Actor's webhook collection
+     * @see https://docs.apify.com/api/v2/act-webhooks-get
      */ webhooks() {
         return new _webhook_collection__rspack_import_10.WebhookCollectionClient(this._subResourceOptions());
     }
@@ -57793,15 +58148,37 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class ActorCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Actors in your account.
+ *
+ * Provides methods to list and create Actors. To access an individual Actor,
+ * use the `actor()` method on the main ApifyClient.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const actorsClient = client.actors();
+ *
+ * // List all Actors
+ * const { items } = await actorsClient.list();
+ *
+ * // Create a new Actor
+ * const newActor = await actorsClient.create({
+ *   name: 'my-actor',
+ *   title: 'My Actor'
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors
+ */ class ActorCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/actor-collection/get-list-of-actors
+     * Lists all Actors.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -57809,6 +58186,10 @@ class ActorCollectionClient extends _base_resource_collection_client__rspack_imp
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination options.
+     * @returns A paginated iterator of Actors.
+     * @see https://docs.apify.com/api/v2/acts-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -57821,7 +58202,11 @@ class ActorCollectionClient extends _base_resource_collection_client__rspack_imp
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/actor-collection/create-actor
+     * Creates a new Actor.
+     *
+     * @param actor - The Actor data.
+     * @returns The created Actor object.
+     * @see https://docs.apify.com/api/v2/acts-post
      */ async create(actor) {
         ow__rspack_import_1_default()(actor, (ow__rspack_import_1_default().optional.object));
         return this._create(actor);
@@ -57854,20 +58239,50 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_client__rspack_import_0 = __webpack_require__("./src/base/resource_client.ts");
 
 
-class ActorEnvVarClient extends _base_resource_client__rspack_import_0.ResourceClient {
+/**
+ * Client for managing a specific Actor environment variable.
+ *
+ * Environment variables are key-value pairs that are available to the Actor during execution.
+ * This client provides methods to get, update, and delete environment variables.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const actorClient = client.actor('my-actor-id');
+ * const versionClient = actorClient.version('0.1');
+ *
+ * // Get an environment variable
+ * const envVarClient = versionClient.envVar('MY_VAR');
+ * const envVar = await envVarClient.get();
+ *
+ * // Update environment variable
+ * await envVarClient.update({ value: 'new-value' });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/development/actor-definition/environment-variables
+ */ class ActorEnvVarClient extends _base_resource_client__rspack_import_0.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/environment-variable-object/get-environment-variable
+     * Retrieves the environment variable.
+     *
+     * @returns The environment variable object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/act-version-env-var-get
      */ async get() {
         return this._get();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/environment-variable-object/update-environment-variable
+     * Updates the environment variable.
+     *
+     * @param actorEnvVar - The updated environment variable data.
+     * @returns The updated environment variable object.
+     * @see https://docs.apify.com/api/v2/act-version-env-var-put
      */ async update(actorEnvVar) {
         ow__rspack_import_1_default()(actorEnvVar, (ow__rspack_import_1_default().object));
         return this._update(actorEnvVar);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/environment-variable-object/delete-environment-variable
+     * Deletes the environment variable.
+     *
+     * @see https://docs.apify.com/api/v2/act-version-env-var-delete
      */ async delete() {
         return this._delete();
     }
@@ -57894,15 +58309,40 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class ActorEnvVarCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of environment variables for an Actor version.
+ *
+ * Environment variables are key-value pairs that are available to the Actor during execution.
+ * This client provides methods to list and create environment variables.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const actorClient = client.actor('my-actor-id');
+ * const versionClient = actorClient.version('0.1');
+ *
+ * // List all environment variables
+ * const envVarsClient = versionClient.envVars();
+ * const { items } = await envVarsClient.list();
+ *
+ * // Create a new environment variable
+ * const newEnvVar = await envVarsClient.create({
+ *   name: 'MY_VAR',
+ *   value: 'my-value',
+ *   isSecret: false
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/development/actor-definition/environment-variables
+ */ class ActorEnvVarCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/environment-variable-collection/get-list-of-environment-variables
+     * Lists all environment variables of this Actor version.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -57910,6 +58350,10 @@ class ActorEnvVarCollectionClient extends _base_resource_collection_client__rspa
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination options.
+     * @returns A paginated iterator of environment variables.
+     * @see https://docs.apify.com/api/v2/act-version-env-vars-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -57920,7 +58364,11 @@ class ActorEnvVarCollectionClient extends _base_resource_collection_client__rspa
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/environment-variable-collection/create-environment-variable
+     * Creates a new environment variable for this Actor version.
+     *
+     * @param actorEnvVar - The environment variable data.
+     * @returns The created environment variable object.
+     * @see https://docs.apify.com/api/v2/act-version-env-vars-post
      */ async create(actorEnvVar) {
         ow__rspack_import_1_default()(actorEnvVar, (ow__rspack_import_1_default().optional.object));
         return this._create(actorEnvVar);
@@ -57953,25 +58401,58 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class ActorVersionClient extends _base_resource_client__rspack_import_0.ResourceClient {
+/**
+ * Client for managing a specific Actor version.
+ *
+ * Actor versions represent specific builds or snapshots of an Actor's code. This client provides
+ * methods to get, update, and delete versions, as well as manage their environment variables.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const actorClient = client.actor('my-actor-id');
+ *
+ * // Get a specific version
+ * const versionClient = actorClient.version('0.1');
+ * const version = await versionClient.get();
+ *
+ * // Update version
+ * await versionClient.update({ buildTag: 'latest' });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/development/actor-definition/versions
+ */ class ActorVersionClient extends _base_resource_client__rspack_import_0.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/version-object/get-version
+     * Retrieves the Actor version.
+     *
+     * @returns The Actor version object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/act-version-get
      */ async get() {
         return this._get();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/version-object/update-version
+     * Updates the Actor version with the specified fields.
+     *
+     * @param newFields - Fields to update.
+     * @returns The updated Actor version object.
+     * @see https://docs.apify.com/api/v2/act-version-put
      */ async update(newFields) {
         ow__rspack_import_3_default()(newFields, (ow__rspack_import_3_default().object));
         return this._update(newFields);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/version-object/delete-version
+     * Deletes the Actor version.
+     *
+     * @see https://docs.apify.com/api/v2/act-version-delete
      */ async delete() {
         return this._delete();
     }
     /**
-     * TODO: https://docs.apify.com/api/v2#/reference/actors/env-var-object
+     * Returns a client for the specified environment variable of this Actor version.
+     *
+     * @param envVarName - Name of the environment variable.
+     * @returns A client for the environment variable.
+     * @see https://docs.apify.com/api/v2/act-version-env-var-get
      */ envVar(envVarName) {
         ow__rspack_import_3_default()(envVarName, (ow__rspack_import_3_default().string));
         return new _actor_env_var__rspack_import_1.ActorEnvVarClient(this._subResourceOptions({
@@ -57979,8 +58460,10 @@ class ActorVersionClient extends _base_resource_client__rspack_import_0.Resource
         }));
     }
     /**
-     * TODO: https://docs.apify.com/api/v2#/reference/actors/env-var-collection
-     * @return {ActorVersionCollectionClient}
+     * Returns a client for the environment variables of this Actor version.
+     *
+     * @returns A client for the Actor version's environment variables.
+     * @see https://docs.apify.com/api/v2/act-version-env-vars-get
      */ envVars() {
         return new _actor_env_var_collection__rspack_import_2.ActorEnvVarCollectionClient(this._subResourceOptions());
     }
@@ -58014,15 +58497,38 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class ActorVersionCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Actor versions.
+ *
+ * Actor versions represent specific builds or snapshots of an Actor's code. This client provides
+ * methods to list and create versions for a specific Actor.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const actorClient = client.actor('my-actor-id');
+ *
+ * // List all versions
+ * const versionsClient = actorClient.versions();
+ * const { items } = await versionsClient.list();
+ *
+ * // Create a new version
+ * const newVersion = await versionsClient.create({
+ *   versionNumber: '0.2',
+ *   buildTag: 'latest'
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/development/actor-definition/versions
+ */ class ActorVersionCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/version-collection/get-list-of-versions
+     * Lists all Actor versions.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -58030,6 +58536,10 @@ class ActorVersionCollectionClient extends _base_resource_collection_client__rsp
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination options.
+     * @returns A paginated iterator of Actor versions.
+     * @see https://docs.apify.com/api/v2/act-versions-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -58040,7 +58550,11 @@ class ActorVersionCollectionClient extends _base_resource_collection_client__rsp
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/version-collection/create-version
+     * Creates a new Actor version.
+     *
+     * @param actorVersion - The Actor version data.
+     * @returns The created Actor version object.
+     * @see https://docs.apify.com/api/v2/act-versions-post
      */ async create(actorVersion) {
         ow__rspack_import_1_default()(actorVersion, (ow__rspack_import_1_default().optional.object));
         return this._create(actorVersion);
@@ -58072,9 +58586,46 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class BuildClient extends _base_resource_client__rspack_import_0.ResourceClient {
+/**
+ * Client for managing a specific Actor build.
+ *
+ * Builds are created when an Actor is built from source code. This client provides methods
+ * to get build details, wait for the build to finish, abort it, and access its logs.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const buildClient = client.build('my-build-id');
+ *
+ * // Get build details
+ * const build = await buildClient.get();
+ *
+ * // Wait for the build to finish
+ * const finishedBuild = await buildClient.waitForFinish();
+ *
+ * // Access build logs
+ * const log = await buildClient.log().get();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running/runs-and-builds#builds
+ */ class BuildClient extends _base_resource_client__rspack_import_0.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-builds/build-object/get-build
+     * Gets the Actor build object from the Apify API.
+     *
+     * @param options - Get options
+     * @param options.waitForFinish - Maximum time to wait (in seconds, max 60s) for the build to finish on the API side before returning. Default is 0 (returns immediately).
+     * @returns The Build object, or `undefined` if it does not exist
+     * @see https://docs.apify.com/api/v2/actor-build-get
+     *
+     * @example
+     * ```javascript
+     * // Get build status immediately
+     * const build = await client.build('build-id').get();
+     * console.log(`Status: ${build.status}`);
+     *
+     * // Wait up to 60 seconds for build to finish
+     * const build = await client.build('build-id').get({ waitForFinish: 60 });
+     * ```
      */ async get() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_3_default()(options, ow__rspack_import_3_default().object.exactShape({
@@ -58083,7 +58634,17 @@ class BuildClient extends _base_resource_client__rspack_import_0.ResourceClient
         return this._get(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-builds/abort-build/abort-build
+     * Aborts the Actor build.
+     *
+     * Stops the build process immediately. The build will have an `ABORTED` status.
+     *
+     * @returns The updated Build object with `ABORTED` status
+     * @see https://docs.apify.com/api/v2/actor-build-abort-post
+     *
+     * @example
+     * ```javascript
+     * await client.build('build-id').abort();
+     * ```
      */ async abort() {
         const response = await this.httpClient.call({
             url: this._url('abort'),
@@ -58093,12 +58654,17 @@ class BuildClient extends _base_resource_client__rspack_import_0.ResourceClient
         return (0,_utils__rspack_import_1.cast)((0,_utils__rspack_import_1.parseDateFields)((0,_utils__rspack_import_1.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-builds/delete-build/delete-build
+     * Deletes the Actor build.
+     *
+     * @see https://docs.apify.com/api/v2/actor-build-delete
      */ async delete() {
         return this._delete();
     }
     /**
-     * https://docs.apify.com/api/v2/actor-build-openapi-json-get
+     * Retrieves the OpenAPI definition for the Actor build.
+     *
+     * @returns The OpenAPI definition object.
+     * @see https://docs.apify.com/api/v2/actor-build-openapi-json-get
      */ async getOpenApiDefinition() {
         const response = await this.httpClient.call({
             url: this._url('openapi.json'),
@@ -58108,15 +58674,34 @@ class BuildClient extends _base_resource_client__rspack_import_0.ResourceClient
         return response.data;
     }
     /**
-     * Returns a promise that resolves with the finished Build object when the provided actor build finishes
-     * or with the unfinished Build object when the `waitSecs` timeout lapses. The promise is NOT rejected
-     * based on run status. You can inspect the `status` property of the Build object to find out its status.
+     * Waits for the Actor build to finish and returns the finished Build object.
+     *
+     * The promise resolves when the build reaches a terminal state (`SUCCEEDED`, `FAILED`, `ABORTED`, or `TIMED-OUT`).
+     * If `waitSecs` is provided and the timeout is reached, the promise resolves with the unfinished
+     * Build object (status will be `RUNNING` or `READY`). The promise is NOT rejected based on build status.
      *
-     * The difference between this function and the `waitForFinish` parameter of the `get` method
-     * is the fact that this function can wait indefinitely. Its use is preferable to the
-     * `waitForFinish` parameter alone, which it uses internally.
+     * Unlike the `waitForFinish` parameter in {@link get}, this method can wait indefinitely
+     * by polling the build status. It uses the `waitForFinish` parameter internally (max 60s per call)
+     * and continuously polls until the build finishes or the timeout is reached.
      *
      * This is useful when you need to immediately start a run after a build finishes.
+     *
+     * @param options - Wait options
+     * @param options.waitSecs - Maximum time to wait for the build to finish, in seconds. If omitted, waits indefinitely.
+     * @returns The Build object (finished or still building if timeout was reached)
+     *
+     * @example
+     * ```javascript
+     * // Wait indefinitely for build to finish
+     * const build = await client.build('build-id').waitForFinish();
+     * console.log(`Build finished with status: ${build.status}`);
+     *
+     * // Start a run immediately after build succeeds
+     * const build = await client.build('build-id').waitForFinish();
+     * if (build.status === 'SUCCEEDED') {
+     *   const run = await client.actor('my-actor').start();
+     * }
+     * ```
      */ async waitForFinish() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_3_default()(options, ow__rspack_import_3_default().object.exactShape({
@@ -58125,7 +58710,17 @@ class BuildClient extends _base_resource_client__rspack_import_0.ResourceClient
         return this._waitForFinish(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-builds/build-log
+     * Returns a client for accessing the log of this Actor build.
+     *
+     * @returns A client for accessing the build's log
+     * @see https://docs.apify.com/api/v2/actor-build-log-get
+     *
+     * @example
+     * ```javascript
+     * // Get build log
+     * const log = await client.build('build-id').log().get();
+     * console.log(log);
+     * ```
      */ log() {
         return new _log__rspack_import_2.LogClient(this._subResourceOptions({
             resourcePath: 'log'
@@ -58154,15 +58749,35 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class BuildCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Actor builds.
+ *
+ * Provides methods to list Actor builds across all Actors or for a specific Actor.
+ * To access an individual build, use the `build()` method on the main ApifyClient.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ *
+ * // List all builds
+ * const buildsClient = client.builds();
+ * const { items } = await buildsClient.list();
+ *
+ * // List builds for a specific Actor
+ * const actorBuildsClient = client.actor('my-actor-id').builds();
+ * const { items: actorBuilds } = await actorBuildsClient.list();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running/runs-and-builds#builds
+ */ class BuildCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/build-collection/get-list-of-builds
+     * Lists all Actor builds.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -58170,6 +58785,10 @@ class BuildCollectionClient extends _base_resource_collection_client__rspack_imp
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination and sorting options.
+     * @returns A paginated iterator of Actor builds.
+     * @see https://docs.apify.com/api/v2/actor-builds-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -58207,25 +58826,102 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class DatasetClient extends _base_resource_client__rspack_import_1.ResourceClient {
+/**
+ * Client for managing a specific Dataset.
+ *
+ * Datasets store structured data results from Actor runs. This client provides methods to push items,
+ * list and retrieve items, download items in various formats (JSON, CSV, Excel, etc.), and manage
+ * the dataset.
+ *
+ * @template Data - Type of items stored in the dataset
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const datasetClient = client.dataset('my-dataset-id');
+ *
+ * // Push items to the dataset
+ * await datasetClient.pushItems([
+ *   { url: 'https://example.com', title: 'Example' },
+ *   { url: 'https://test.com', title: 'Test' }
+ * ]);
+ *
+ * // List all items
+ * const { items } = await datasetClient.listItems();
+ *
+ * // Download items as CSV
+ * const buffer = await datasetClient.downloadItems('csv');
+ * ```
+ *
+ * @see https://docs.apify.com/platform/storage/dataset
+ */ class DatasetClient extends _base_resource_client__rspack_import_1.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/dataset/get-dataset
+     * Gets the dataset object from the Apify API.
+     *
+     * @returns The Dataset object, or `undefined` if it does not exist
+     * @see https://docs.apify.com/api/v2/dataset-get
      */ async get() {
         return this._get({}, _base_resource_client__rspack_import_1.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/dataset/update-dataset
+     * Updates the dataset with specified fields.
+     *
+     * @param newFields - Fields to update in the dataset
+     * @returns The updated Dataset object
+     * @see https://docs.apify.com/api/v2/dataset-put
      */ async update(newFields) {
         ow__rspack_import_3_default()(newFields, (ow__rspack_import_3_default().object));
         return this._update(newFields, _base_resource_client__rspack_import_1.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/dataset/delete-dataset
+     * Deletes the dataset.
+     *
+     * @see https://docs.apify.com/api/v2/dataset-delete
      */ async delete() {
         return this._delete(_base_resource_client__rspack_import_1.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/item-collection/get-items
+     * Lists items in the dataset.
+     *
+     * Returns a paginated list of dataset items. You can use pagination parameters to retrieve
+     * specific subsets of items, and various filtering and formatting options to customize
+     * the output.
+     *
+     * @param options - Options for listing items
+     * @param options.limit - Maximum number of items to return. Default is all items.
+     * @param options.offset - Number of items to skip from the beginning. Default is 0.
+     * @param options.desc - If `true`, items are returned in descending order (newest first). Default is `false`.
+     * @param options.fields - Array of field names to include in the results. Omits all other fields.
+     * @param options.omit - Array of field names to exclude from the results.
+     * @param options.clean - If `true`, returns only non-empty items and skips hidden fields. Default is `false`.
+     * @param options.skipEmpty - If `true`, skips empty items. Default is `false`.
+     * @param options.skipHidden - If `true`, skips hidden fields (fields starting with `#`). Default is `false`.
+     * @param options.flatten - Array of field names to flatten. Nested objects are converted to dot notation (e.g., `obj.field`).
+     * @param options.unwind - Field name or array of field names to unwind. Each array value creates a separate item.
+     * @param options.view - Name of a predefined view to use for field selection.
+     * @returns A paginated list with `items`, `total` count, `offset`, `count`, and `limit`
+     * @see https://docs.apify.com/api/v2/dataset-items-get
+     *
+     * @example
+     * ```javascript
+     * // Get first 100 items
+     * const { items, total } = await client.dataset('my-dataset').listItems({ limit: 100 });
+     * console.log(`Retrieved ${items.length} of ${total} total items`);
+     *
+     * // Get items with specific fields only
+     * const { items } = await client.dataset('my-dataset').listItems({
+     *   fields: ['url', 'title'],
+     *   skipEmpty: true,
+     *   limit: 50
+     * });
+     *
+     * // Get items in descending order with pagination
+     * const { items } = await client.dataset('my-dataset').listItems({
+     *   desc: true,
+     *   offset: 100,
+     *   limit: 50
+     * });
+     * ```
      */ async listItems() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_3_default()(options, ow__rspack_import_3_default().object.exactShape({
@@ -58251,9 +58947,44 @@ class DatasetClient extends _base_resource_client__rspack_import_1.ResourceClien
         return this._createPaginationList(response, options.desc ?? false);
     }
     /**
-     * Unlike `listItems` which returns a {@link PaginationList} with an array of individual
-     * dataset items, `downloadItems` returns the items serialized to the provided format.
-     * https://docs.apify.com/api/v2#/reference/datasets/item-collection/get-items
+     * Downloads dataset items in a specific format.
+     *
+     * Unlike {@link listItems} which returns a {@link PaginatedList} with an array of individual
+     * dataset items, this method returns the items serialized to the provided format
+     * (JSON, CSV, Excel, etc.) as a Buffer. Useful for exporting data for further processing.
+     *
+     * @param format - Output format: `'json'`, `'jsonl'`, `'csv'`, `'xlsx'`, `'xml'`, `'rss'`, or `'html'`
+     * @param options - Download and formatting options (extends all options from {@link listItems})
+     * @param options.attachment - If `true`, the response will have `Content-Disposition: attachment` header.
+     * @param options.bom - If `true`, adds UTF-8 BOM to the beginning of the file (useful for Excel compatibility).
+     * @param options.delimiter - CSV delimiter character. Default is `,` (comma).
+     * @param options.skipHeaderRow - If `true`, CSV export will not include the header row with field names.
+     * @param options.xmlRoot - Name of the root XML element. Default is `'items'`.
+     * @param options.xmlRow - Name of the XML element for each item. Default is `'item'`.
+     * @param options.fields - Array of field names to include in the export.
+     * @param options.omit - Array of field names to exclude from the export.
+     * @returns Buffer containing the serialized data in the specified format
+     * @see https://docs.apify.com/api/v2/dataset-items-get
+     *
+     * @example
+     * ```javascript
+     * // Download as CSV with BOM for Excel compatibility
+     * const csvBuffer = await client.dataset('my-dataset').downloadItems('csv', { bom: true });
+     * require('fs').writeFileSync('output.csv', csvBuffer);
+     *
+     * // Download as Excel with custom options
+     * const xlsxBuffer = await client.dataset('my-dataset').downloadItems('xlsx', {
+     *   fields: ['url', 'title', 'price'],
+     *   skipEmpty: true,
+     *   limit: 1000
+     * });
+     *
+     * // Download as XML with custom element names
+     * const xmlBuffer = await client.dataset('my-dataset').downloadItems('xml', {
+     *   xmlRoot: 'products',
+     *   xmlRow: 'product'
+     * });
+     * ```
      */ async downloadItems(format) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_3_default()(format, ow__rspack_import_3_default().string.oneOf(validItemFormats));
@@ -58290,8 +59021,37 @@ class DatasetClient extends _base_resource_client__rspack_import_1.ResourceClien
         return (0,_utils__rspack_import_2.cast)(data);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/item-collection/put-items
-     */ async pushItems(items) {
+     * Stores one or more items into the dataset.
+     *
+     * Items can be objects, strings, or arrays thereof. Each item will be stored as a separate
+     * record in the dataset. Objects are automatically serialized to JSON. If you provide an array,
+     * all items will be stored in order. This method is idempotent - calling it multiple times
+     * with the same data will not create duplicates, but will append items each time.
+     *
+     * @param items - A single item (object or string) or an array of items to store.
+     *                Objects are automatically stringified to JSON. Strings are stored as-is.
+     * @see https://docs.apify.com/api/v2/dataset-items-post
+     *
+     * @example
+     * ```javascript
+     * // Store a single object
+     * await client.dataset('my-dataset').pushItems({
+     *   url: 'https://example.com',
+     *   title: 'Example Page',
+     *   extractedAt: new Date()
+     * });
+     *
+     * // Store multiple items at once
+     * await client.dataset('my-dataset').pushItems([
+     *   { url: 'https://example.com', title: 'Example' },
+     *   { url: 'https://test.com', title: 'Test' },
+     *   { url: 'https://demo.com', title: 'Demo' }
+     * ]);
+     *
+     * // Store string items
+     * await client.dataset('my-dataset').pushItems(['item1', 'item2', 'item3']);
+     * ```
+     */ async pushItems(items) {
         ow__rspack_import_3_default()(items, ow__rspack_import_3_default().any((ow__rspack_import_3_default().object), (ow__rspack_import_3_default().string), ow__rspack_import_3_default().array.ofType(ow__rspack_import_3_default().any((ow__rspack_import_3_default().object), (ow__rspack_import_3_default().string)))));
         await this.httpClient.call({
             url: this._url('items'),
@@ -58306,7 +59066,13 @@ class DatasetClient extends _base_resource_client__rspack_import_1.ResourceClien
         });
     }
     /**
-     * https://docs.apify.com/api/v2#tag/DatasetsStatistics/operation/dataset_statistics_get
+     * Gets statistical information about the dataset.
+     *
+     * Returns statistics for each field in the dataset, including information about
+     * data types, null counts, and value ranges.
+     *
+     * @returns Dataset statistics, or `undefined` if not available
+     * @see https://docs.apify.com/api/v2/dataset-statistics-get
      */ async getStatistics() {
         const requestOpts = {
             url: this._url('statistics'),
@@ -58323,16 +59089,35 @@ class DatasetClient extends _base_resource_client__rspack_import_1.ResourceClien
         return undefined;
     }
     /**
-     * Generates a URL that can be used to access dataset items.
+     * Generates a public URL for accessing dataset items.
      *
      * If the client has permission to access the dataset's URL signing key,
-     * the URL will include a signature which will allow the link to work even without authentication.
+     * the URL will include a cryptographic signature allowing access without authentication.
+     * This is useful for sharing dataset results with external services or users.
      *
-     * You can optionally control how long the signed URL should be valid using the `expiresInSecs` option.
-     * This value sets the expiration duration in seconds from the time the URL is generated.
-     * If not provided, the URL will not expire.
+     * @param options - URL generation options (extends all options from {@link listItems})
+     * @param options.expiresInSecs - Number of seconds until the signed URL expires. If omitted, the URL never expires.
+     * @param options.fields - Array of field names to include in the response.
+     * @param options.limit - Maximum number of items to return.
+     * @param options.offset - Number of items to skip.
+     * @returns A public URL string for accessing the dataset items
      *
-     * Any other options (like `limit` or `prefix`) will be included as query parameters in the URL.
+     * @example
+     * ```javascript
+     * // Create a URL that expires in 1 hour with specific fields
+     * const url = await client.dataset('my-dataset').createItemsPublicUrl({
+     *   expiresInSecs: 3600,
+     *   fields: ['url', 'title'],
+     *   limit: 100
+     * });
+     * console.log(`Share this URL: ${url}`);
+     *
+     * // Create a permanent public URL for clean items only
+     * const url = await client.dataset('my-dataset').createItemsPublicUrl({
+     *   clean: true,
+     *   skipEmpty: true
+     * });
+     * ```
      */ async createItemsPublicUrl() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_3_default()(options, ow__rspack_import_3_default().object.exactShape({
@@ -58383,7 +59168,9 @@ class DatasetClient extends _base_resource_client__rspack_import_1.ResourceClien
         });
     }
 }
-var DownloadItemsFormat = /*#__PURE__*/ function(DownloadItemsFormat) {
+/**
+ * Supported formats for downloading dataset items.
+ */ var DownloadItemsFormat = /*#__PURE__*/ function(DownloadItemsFormat) {
     DownloadItemsFormat["JSON"] = "json";
     DownloadItemsFormat["JSONL"] = "jsonl";
     DownloadItemsFormat["XML"] = "xml";
@@ -58410,15 +59197,34 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class DatasetCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of datasets in your account.
+ *
+ * Datasets store structured data results from Actor runs. This client provides methods
+ * to list, create, or get datasets by name.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const datasetsClient = client.datasets();
+ *
+ * // List all datasets
+ * const { items } = await datasetsClient.list();
+ *
+ * // Get or create a dataset by name
+ * const dataset = await datasetsClient.getOrCreate('my-dataset');
+ * ```
+ *
+ * @see https://docs.apify.com/platform/storage/dataset
+ */ class DatasetCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/dataset-collection/get-list-of-datasets
+     * Lists all Datasets.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -58426,6 +59232,10 @@ class DatasetCollectionClient extends _base_resource_collection_client__rspack_i
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination options.
+     * @returns A paginated iterator of Datasets.
+     * @see https://docs.apify.com/api/v2/datasets-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -58437,7 +59247,12 @@ class DatasetCollectionClient extends _base_resource_collection_client__rspack_i
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/datasets/dataset-collection/create-dataset
+     * Gets or creates a dataset with the specified name.
+     *
+     * @param name - Name of the dataset. If not provided, a default dataset is used.
+     * @param options - Additional options like schema.
+     * @returns The dataset object.
+     * @see https://docs.apify.com/api/v2/datasets-post
      */ async getOrCreate(name, options) {
         ow__rspack_import_1_default()(name, (ow__rspack_import_1_default().optional.string));
         ow__rspack_import_1_default()(options === null || options === void 0 ? void 0 : options.schema, (ow__rspack_import_1_default().optional.object)); // TODO: Add schema validatioon
@@ -58472,25 +59287,96 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class KeyValueStoreClient extends _base_resource_client__rspack_import_2.ResourceClient {
+/**
+ * Client for managing a specific key-value store.
+ *
+ * Key-value stores are used to store arbitrary data records or files. Each record is identified by
+ * a unique key and can contain any type of data. This client provides methods to get, set, and delete
+ * records, list keys, and manage the store.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const storeClient = client.keyValueStore('my-store-id');
+ *
+ * // Set a record
+ * await storeClient.setRecord({
+ *   key: 'OUTPUT',
+ *   value: { foo: 'bar' },
+ *   contentType: 'application/json'
+ * });
+ *
+ * // Get a record
+ * const record = await storeClient.getRecord('OUTPUT');
+ *
+ * // List all keys
+ * const { items } = await storeClient.listKeys();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/storage/key-value-store
+ */ class KeyValueStoreClient extends _base_resource_client__rspack_import_2.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/store-object/get-store
+     * Gets the key-value store object from the Apify API.
+     *
+     * @returns The KeyValueStore object, or `undefined` if it does not exist
+     * @see https://docs.apify.com/api/v2/key-value-store-get
      */ async get() {
         return this._get({}, _base_resource_client__rspack_import_2.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/store-object/update-store
+     * Updates the key-value store with specified fields.
+     *
+     * @param newFields - Fields to update in the key-value store
+     * @param newFields.name - New name for the store
+     * @param newFields.title - New title for the store
+     * @param newFields.generalAccess - General resource access level ('FOLLOW_USER_SETTING', 'ANYONE_WITH_ID_CAN_READ' or 'RESTRICTED')
+     * @returns The updated KeyValueStore object
+     * @see https://docs.apify.com/api/v2/key-value-store-put
      */ async update(newFields) {
         ow__rspack_import_4_default()(newFields, (ow__rspack_import_4_default().object));
         return this._update(newFields, _base_resource_client__rspack_import_2.DEFAULT_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/store-object/delete-store
+     * Deletes the key-value store.
+     *
+     * @see https://docs.apify.com/api/v2/key-value-store-delete
      */ async delete() {
         return this._delete(_base_resource_client__rspack_import_2.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/key-collection/get-list-of-keys
+     * Lists all keys in the key-value store.
+     *
+     * Returns a paginated list of all record keys in the store. Use pagination parameters
+     * to retrieve large lists efficiently.
+     *
+     * @param options - Listing options
+     * @param options.limit - Maximum number of keys to return. Default is 1000.
+     * @param options.exclusiveStartKey - Key to start listing from (for pagination). The listing starts with the next key after this one.
+     * @param options.collection - Filter keys by collection name.
+     * @param options.prefix - Filter keys that start with this prefix.
+     * @returns Object containing `items` array of key metadata, pagination info (`count`, `limit`, `isTruncated`, `nextExclusiveStartKey`)
+     * @see https://docs.apify.com/api/v2/key-value-store-keys-get
+     *
+     * @example
+     * ```javascript
+     * // List all keys
+     * const { items, isTruncated } = await client.keyValueStore('my-store').listKeys();
+     * items.forEach(item => console.log(`${item.key}: ${item.size} bytes`));
+     *
+     * // List keys with prefix
+     * const { items } = await client.keyValueStore('my-store').listKeys({ prefix: 'user-' });
+     *
+     * // Paginate through all keys
+     * let exclusiveStartKey;
+     * do {
+     *   const result = await client.keyValueStore('my-store').listKeys({
+     *     limit: 100,
+     *     exclusiveStartKey
+     *   });
+     *   // Process result.items...
+     *   exclusiveStartKey = result.nextExclusiveStartKey;
+     * } while (result.isTruncated);
+     * ```
      */ async listKeys() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_4_default()(options, ow__rspack_import_4_default().object.exactShape({
@@ -58509,10 +59395,21 @@ class KeyValueStoreClient extends _base_resource_client__rspack_import_2.Resourc
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * Generates a URL that can be used to access key-value store record.
+     * Generates a public URL for accessing a specific record in the key-value store.
      *
      * If the client has permission to access the key-value store's URL signing key,
-     * the URL will include a signature to verify its authenticity.
+     * the URL will include a cryptographic signature for authenticated access without
+     * requiring an API token.
+     *
+     * @param key - The record key
+     * @returns A public URL string for accessing the record
+     *
+     * @example
+     * ```javascript
+     * const url = await client.keyValueStore('my-store').getRecordPublicUrl('OUTPUT');
+     * console.log(`Public URL: ${url}`);
+     * // You can now share this URL or use it in a browser
+     * ```
      */ async getRecordPublicUrl(key) {
         ow__rspack_import_4_default()(key, (ow__rspack_import_4_default().string.nonEmpty));
         const store = await this.get();
@@ -58524,16 +59421,26 @@ class KeyValueStoreClient extends _base_resource_client__rspack_import_2.Resourc
         return recordPublicUrl.toString();
     }
     /**
-     * Generates a URL that can be used to access key-value store keys.
+     * Generates a public URL for accessing the list of keys in the key-value store.
      *
      * If the client has permission to access the key-value store's URL signing key,
-     * the URL will include a signature which will allow the link to work even without authentication.
+     * the URL will include a cryptographic signature which allows access without authentication.
      *
-     * You can optionally control how long the signed URL should be valid using the `expiresInSecs` option.
-     * This value sets the expiration duration in seconds from the time the URL is generated.
-     * If not provided, the URL will not expire.
+     * @param options - URL generation options (extends all options from {@link listKeys})
+     * @param options.expiresInSecs - Number of seconds until the signed URL expires. If omitted, the URL never expires.
+     * @param options.limit - Maximum number of keys to return.
+     * @param options.prefix - Filter keys by prefix.
+     * @returns A public URL string for accessing the keys list
      *
-     * Any other options (like `limit` or `prefix`) will be included as query parameters in the URL.
+     * @example
+     * ```javascript
+     * // Create a URL that expires in 1 hour
+     * const url = await client.keyValueStore('my-store').createKeysPublicUrl({
+     *   expiresInSecs: 3600,
+     *   prefix: 'image-'
+     * });
+     * console.log(`Share this URL: ${url}`);
+     * ```
      */ async createKeysPublicUrl() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_4_default()(options, ow__rspack_import_4_default().object.exactShape({
@@ -58560,9 +59467,19 @@ class KeyValueStoreClient extends _base_resource_client__rspack_import_2.Resourc
     /**
      * Tests whether a record with the given key exists in the key-value store without retrieving its value.
      *
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/record/get-record
-     * @param key The queried record key.
-     * @returns `true` if the record exists, `false` if it does not.
+     * This is more efficient than {@link getRecord} when you only need to check for existence.
+     *
+     * @param key - The record key to check
+     * @returns `true` if the record exists, `false` if it does not
+     * @see https://docs.apify.com/api/v2/key-value-store-record-get
+     *
+     * @example
+     * ```javascript
+     * const exists = await client.keyValueStore('my-store').recordExists('OUTPUT');
+     * if (exists) {
+     *   console.log('OUTPUT record exists');
+     * }
+     * ```
      */ async recordExists(key) {
         const requestOpts = {
             url: this._url(`records/${key}`),
@@ -58615,15 +59532,51 @@ class KeyValueStoreClient extends _base_resource_client__rspack_import_2.Resourc
         return undefined;
     }
     /**
-     * The value in the record can be a stream object (detected by having the `.pipe`
-     * and `.on` methods). However, note that in that case following redirects or
-     * retrying the request if it fails (for example due to rate limiting) isn't
-     * possible. If you want to keep that behavior, you need to collect the whole
-     * stream contents into a Buffer and then send the full buffer. See [this
-     * StackOverflow answer](https://stackoverflow.com/a/14269536/7292139) for
-     * an example how to do that.
+     * Stores a record in the key-value store.
+     *
+     * The record value can be any JSON-serializable object, a string, or a Buffer/Stream.
+     * The content type is automatically determined based on the value type, but can be
+     * overridden using the `contentType` property.
+     *
+     * **Note about streams:** If the value is a stream object (has `.pipe` and `.on` methods),
+     * the upload cannot be retried on failure or follow redirects. For reliable uploads,
+     * buffer the entire stream into memory first.
+     *
+     * @param record - The record to store
+     * @param record.key - Record key (unique identifier)
+     * @param record.value - Record value (object, string, Buffer, or Stream)
+     * @param record.contentType - Optional MIME type. Auto-detected if not provided:
+     *                             - Objects: `'application/json; charset=utf-8'`
+     *                             - Strings: `'text/plain; charset=utf-8'`
+     *                             - Buffers/Streams: `'application/octet-stream'`
+     * @param options - Storage options
+     * @param options.timeoutSecs - Timeout for the upload in seconds. Default varies by value size.
+     * @param options.doNotRetryTimeouts - If `true`, don't retry on timeout errors. Default is `false`.
+     * @see https://docs.apify.com/api/v2/key-value-store-record-put
      *
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/record/put-record
+     * @example
+     * ```javascript
+     * // Store JSON object
+     * await client.keyValueStore('my-store').setRecord({
+     *   key: 'OUTPUT',
+     *   value: { crawledUrls: 100, items: [...] }
+     * });
+     *
+     * // Store text
+     * await client.keyValueStore('my-store').setRecord({
+     *   key: 'README',
+     *   value: 'This is my readme text',
+     *   contentType: 'text/plain'
+     * });
+     *
+     * // Store binary data
+     * const imageBuffer = await fetchImageBuffer();
+     * await client.keyValueStore('my-store').setRecord({
+     *   key: 'screenshot.png',
+     *   value: imageBuffer,
+     *   contentType: 'image/png'
+     * });
+     * ```
      */ async setRecord(record) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_4_default()(record, ow__rspack_import_4_default().object.exactShape({
@@ -58668,7 +59621,15 @@ class KeyValueStoreClient extends _base_resource_client__rspack_import_2.Resourc
         await this.httpClient.call(uploadOpts);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/record/delete-record
+     * Deletes a record from the key-value store.
+     *
+     * @param key - The record key to delete
+     * @see https://docs.apify.com/api/v2/key-value-store-record-delete
+     *
+     * @example
+     * ```javascript
+     * await client.keyValueStore('my-store').deleteRecord('temp-data');
+     * ```
      */ async deleteRecord(key) {
         ow__rspack_import_4_default()(key, (ow__rspack_import_4_default().string));
         await this.httpClient.call({
@@ -58701,15 +59662,34 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class KeyValueStoreCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Key-value stores in your account.
+ *
+ * Key-value stores are used to store arbitrary data records or files. This client provides
+ * methods to list, create, or get key-value stores by name.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const storesClient = client.keyValueStores();
+ *
+ * // List all key-value stores
+ * const { items } = await storesClient.list();
+ *
+ * // Get or create a key-value store by name
+ * const store = await storesClient.getOrCreate('my-store');
+ * ```
+ *
+ * @see https://docs.apify.com/platform/storage/key-value-store
+ */ class KeyValueStoreCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/store-collection/get-list-of-key-value-stores
+     * Lists all Key-value stores.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -58717,6 +59697,10 @@ class KeyValueStoreCollectionClient extends _base_resource_collection_client__rs
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination options.
+     * @returns A paginated iterator of Key-value stores.
+     * @see https://docs.apify.com/api/v2/key-value-stores-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -58728,7 +59712,12 @@ class KeyValueStoreCollectionClient extends _base_resource_collection_client__rs
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/key-value-stores/store-collection/create-key-value-store
+     * Gets or creates a key-value store with the specified name.
+     *
+     * @param name - Name of the key-value store. If not provided, a default store is used.
+     * @param options - Additional options like schema.
+     * @returns The key-value store object.
+     * @see https://docs.apify.com/api/v2/key-value-stores-post
      */ async getOrCreate(name, options) {
         ow__rspack_import_1_default()(name, (ow__rspack_import_1_default().optional.string));
         ow__rspack_import_1_default()(options === null || options === void 0 ? void 0 : options.schema, (ow__rspack_import_1_default().optional.object)); // TODO: Add schema validatioon
@@ -58767,9 +59756,35 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class LogClient extends _base_resource_client__rspack_import_2.ResourceClient {
+/**
+ * Client for accessing Actor run or build logs.
+ *
+ * Provides methods to retrieve logs as text or stream them in real-time. Logs can be accessed
+ * for both running and finished Actor runs and builds.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const runClient = client.run('my-run-id');
+ *
+ * // Get the log content
+ * const log = await runClient.log().get();
+ * console.log(log);
+ *
+ * // Stream the log in real-time
+ * const stream = await runClient.log().stream();
+ * stream.on('line', (line) => console.log(line));
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running/runs-and-builds#logging
+ */ class LogClient extends _base_resource_client__rspack_import_2.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/logs/log/get-log
+     * Retrieves the log as a string.
+     *
+     * @param options - Log retrieval options.
+     * @param options.raw - If `true`, returns raw log content without any processing. Default is `false`.
+     * @returns The log content as a string, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/log-get
      */ async get() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         const requestOpts = {
@@ -58786,8 +59801,12 @@ class LogClient extends _base_resource_client__rspack_import_2.ResourceClient {
         return undefined;
     }
     /**
-     * Gets the log in a Readable stream format. Only works in Node.js.
-     * https://docs.apify.com/api/v2#/reference/logs/log/get-log
+     * Retrieves the log as a Readable stream. Only works in Node.js.
+     *
+     * @param options - Log retrieval options.
+     * @param options.raw - If `true`, returns raw log content without any processing. Default is `false`.
+     * @returns The log content as a Readable stream, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/log-get
      */ async stream() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         const params = {
@@ -58979,25 +59998,70 @@ const DEFAULT_UNPROCESSED_RETRIES_BATCH_ADD_REQUESTS = 3;
 const DEFAULT_MIN_DELAY_BETWEEN_UNPROCESSED_REQUESTS_RETRIES_MILLIS = 500;
 const DEFAULT_REQUEST_QUEUE_REQUEST_PAGE_LIMIT = 1000;
 const SAFETY_BUFFER_PERCENT = 0.01 / 100; // 0.01%
-class RequestQueueClient extends _base_resource_client__rspack_import_2.ResourceClient {
+/**
+ * Client for managing a specific Request queue.
+ *
+ * Request queues store URLs to be crawled and their metadata. Each request in the queue has a unique ID
+ * and can be in various states (pending, handled). This client provides methods to add, get, update,
+ * and delete requests, as well as manage the queue itself.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const queueClient = client.requestQueue('my-queue-id');
+ *
+ * // Add a request to the queue
+ * await queueClient.addRequest({
+ *   url: 'https://example.com',
+ *   uniqueKey: 'example-com'
+ * });
+ *
+ * // Get the next request from the queue
+ * const request = await queueClient.listHead();
+ *
+ * // Mark request as handled
+ * await queueClient.updateRequest({
+ *   id: request.id,
+ *   handledAt: new Date().toISOString()
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/storage/request-queue
+ */ class RequestQueueClient extends _base_resource_client__rspack_import_2.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue/get-request-queue
+     * Gets the Request queue object from the Apify API.
+     *
+     * @returns The RequestQueue object, or `undefined` if it does not exist
+     * @see https://docs.apify.com/api/v2/request-queue-get
      */ async get() {
         return this._get({}, _base_resource_client__rspack_import_2.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue/update-request-queue
+     * Updates the Request queue with specified fields.
+     *
+     * @param newFields - Fields to update in the Request queue
+     * @returns The updated RequestQueue object
+     * @see https://docs.apify.com/api/v2/request-queue-put
      */ async update(newFields) {
         ow__rspack_import_4_default()(newFields, (ow__rspack_import_4_default().object));
         return this._update(newFields, _base_resource_client__rspack_import_2.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue/delete-request-queue
+     * Deletes the Request queue.
+     *
+     * @see https://docs.apify.com/api/v2/request-queue-delete
      */ async delete() {
         return this._delete(_base_resource_client__rspack_import_2.SMALL_TIMEOUT_MILLIS);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue-head/get-head
+     * Lists requests from the beginning of the queue (head).
+     *
+     * Returns the first N requests from the queue without locking them. This is useful for
+     * inspecting what requests are waiting to be processed.
+     *
+     * @param options - Options for listing (e.g., limit)
+     * @returns List of requests from the queue head
+     * @see https://docs.apify.com/api/v2/request-queue-head-get
      */ async listHead() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_4_default()(options, ow__rspack_import_4_default().object.exactShape({
@@ -59015,7 +60079,36 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue-head-with-locks/get-head-and-lock
+     * Gets and locks the next requests from the queue head for processing.
+     *
+     * This method retrieves requests from the beginning of the queue and locks them for
+     * the specified duration to prevent other clients from processing them simultaneously.
+     * This is the primary method used by distributed web crawlers to coordinate work across
+     * multiple workers. Locked requests won't be returned to other clients until the lock expires
+     * or is explicitly released using {@link deleteRequestLock}.
+     *
+     * @param options - Lock configuration
+     * @param options.lockSecs - **Required.** Duration in seconds to lock the requests. After this time, the locks expire and requests can be retrieved by other clients.
+     * @param options.limit - Maximum number of requests to return. Default is 25.
+     * @returns Object containing `items` (locked requests), `queueModifiedAt`, `hadMultipleClients`, and lock information
+     * @see https://docs.apify.com/api/v2/request-queue-head-lock-post
+     *
+     * @example
+     * ```javascript
+     * // Get and lock up to 10 requests for 60 seconds
+     * const { items, lockSecs } = await client.requestQueue('my-queue').listAndLockHead({
+     *   lockSecs: 60,
+     *   limit: 10
+     * });
+     *
+     * // Process each locked request
+     * for (const request of items) {
+     *   console.log(`Processing: ${request.url}`);
+     *   // ... process request ...
+     *   // Delete lock after successful processing
+     *   await client.requestQueue('my-queue').deleteRequestLock(request.id);
+     * }
+     * ```
      */ async listAndLockHead(options) {
         ow__rspack_import_4_default()(options, ow__rspack_import_4_default().object.exactShape({
             lockSecs: (ow__rspack_import_4_default().number),
@@ -59034,7 +60127,42 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/request-collection/add-request
+     * Adds a single request to the queue.
+     *
+     * If a request with the same `uniqueKey` already exists, the method will return information
+     * about the existing request without adding a duplicate. The `uniqueKey` is used for
+     * deduplication - typically it's the URL, but you can use any string to identify the request.
+     *
+     * @param request - The request object to add (excluding `id`, which is assigned by the API)
+     * @param request.url - URL to be crawled
+     * @param request.uniqueKey - Unique identifier for request deduplication. If not provided, defaults to `url`.
+     * @param request.method - HTTP method. Default is `'GET'`.
+     * @param request.userData - Custom user data (arbitrary JSON object) associated with the request.
+     * @param request.headers - HTTP headers to use for the request.
+     * @param request.payload - HTTP payload for POST/PUT requests (string).
+     * @param options - Additional options
+     * @param options.forefront - If `true`, adds the request to the beginning of the queue. Default is `false` (adds to the end).
+     * @returns Object with `requestId`, `wasAlreadyPresent`, and `wasAlreadyHandled` flags
+     * @see https://docs.apify.com/api/v2/request-queue-requests-post
+     *
+     * @example
+     * ```javascript
+     * const result = await client.requestQueue('my-queue').addRequest({
+     *   url: 'https://example.com',
+     *   uniqueKey: 'example-page',
+     *   method: 'GET',
+     *   userData: { label: 'START', depth: 0 }
+     * });
+     * console.log(`Request ID: ${result.requestId}`);
+     * console.log(`Already present: ${result.wasAlreadyPresent}`);
+     * console.log(`Already handled: ${result.wasAlreadyHandled}`);
+     *
+     * // Add urgent request to the front of the queue
+     * await client.requestQueue('my-queue').addRequest(
+     *   { url: 'https://priority.com', uniqueKey: 'priority-page' },
+     *   { forefront: true }
+     * );
+     * ```
      */ async addRequest(request) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_4_default()(request, ow__rspack_import_4_default().object.partialShape({
@@ -59056,7 +60184,7 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * Writes requests to request queue in batch.
+     * Writes requests to Request queue in batch.
      *
      * @private
      */ async _batchAddRequests(requests) {
@@ -59149,7 +60277,41 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)(result));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/batch-request-operations/add-requests
+     * Adds multiple requests to the queue in a single operation.
+     *
+     * This is significantly more efficient than calling {@link addRequest} multiple times, especially
+     * for large batches. The method automatically handles batching (max 25 requests per API call),
+     * retries on rate limiting, and parallel processing. Requests are sent in chunks respecting the
+     * API payload size limit, and any unprocessed requests due to rate limits are automatically
+     * retried with exponential backoff.
+     *
+     * @param requests - Array of request objects to add (excluding `id` fields)
+     * @param options - Batch operation configuration
+     * @param options.forefront - If `true`, adds all requests to the beginning of the queue. Default is `false`.
+     * @param options.maxUnprocessedRequestsRetries - Maximum number of retry attempts for rate-limited requests. Default is 3.
+     * @param options.maxParallel - Maximum number of parallel batch API calls. Default is 5.
+     * @param options.minDelayBetweenUnprocessedRequestsRetriesMillis - Minimum delay before retrying rate-limited requests. Default is 500ms.
+     * @returns Object with `processedRequests` (successfully added) and `unprocessedRequests` (failed after all retries)
+     * @see https://docs.apify.com/api/v2/request-queue-requests-batch-post
+     *
+     * @example
+     * ```javascript
+     * // Add a batch of URLs to crawl
+     * const requests = [
+     *   { url: 'https://example.com', uniqueKey: 'page1', userData: { depth: 1 } },
+     *   { url: 'https://example.com/2', uniqueKey: 'page2', userData: { depth: 1 } },
+     *   { url: 'https://example.com/3', uniqueKey: 'page3', userData: { depth: 1 } }
+     * ];
+     * const result = await client.requestQueue('my-queue').batchAddRequests(requests);
+     * console.log(`Successfully added: ${result.processedRequests.length}`);
+     * console.log(`Failed: ${result.unprocessedRequests.length}`);
+     *
+     * // Batch add with custom retry settings
+     * const result = await client.requestQueue('my-queue').batchAddRequests(
+     *   requests,
+     *   { maxUnprocessedRequestsRetries: 5, maxParallel: 10 }
+     * );
+     * ```
      */ async batchAddRequests(requests) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         const { forefront, maxUnprocessedRequestsRetries = DEFAULT_UNPROCESSED_RETRIES_BATCH_ADD_REQUESTS, maxParallel = DEFAULT_PARALLEL_BATCH_ADD_REQUESTS, minDelayBetweenUnprocessedRequestsRetriesMillis = DEFAULT_MIN_DELAY_BETWEEN_UNPROCESSED_REQUESTS_RETRIES_MILLIS } = options;
@@ -59194,7 +60356,13 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return result;
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/batch-request-operations/delete-requests
+     * Deletes multiple requests from the queue in a single operation.
+     *
+     * Requests can be identified by either their ID or unique key.
+     *
+     * @param requests - Array of requests to delete (by id or uniqueKey)
+     * @returns Result containing processed and unprocessed requests
+     * @see https://docs.apify.com/api/v2/request-queue-requests-batch-delete
      */ async batchDeleteRequests(requests) {
         ow__rspack_import_4_default()(requests, ow__rspack_import_4_default().array.ofType(ow__rspack_import_4_default().any(ow__rspack_import_4_default().object.partialShape({
             id: (ow__rspack_import_4_default().string)
@@ -59213,7 +60381,11 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/request/get-request
+     * Gets a specific request from the queue by its ID.
+     *
+     * @param id - Request ID
+     * @returns The request object, or `undefined` if not found
+     * @see https://docs.apify.com/api/v2/request-queue-request-get
      */ async getRequest(id) {
         ow__rspack_import_4_default()(id, (ow__rspack_import_4_default().string));
         const requestOpts = {
@@ -59231,7 +60403,12 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return undefined;
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/request/update-request
+     * Updates a request in the queue.
+     *
+     * @param request - The updated request object (must include id)
+     * @param options - Update options such as whether to move to front
+     * @returns Information about the updated request
+     * @see https://docs.apify.com/api/v2/request-queue-request-put
      */ async updateRequest(request) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_4_default()(request, ow__rspack_import_4_default().object.partialShape({
@@ -59252,7 +60429,11 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         });
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
-    async deleteRequest(id) {
+    /**
+     * Deletes a specific request from the queue.
+     *
+     * @param id - Request ID
+     */ async deleteRequest(id) {
         ow__rspack_import_4_default()(id, (ow__rspack_import_4_default().string));
         await this.httpClient.call({
             url: this._url(`requests/${id}`),
@@ -59264,7 +60445,28 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/request-lock/prolong-request-lock
+     * Prolongs the lock on a request to prevent it from being returned to other clients.
+     *
+     * This is useful when processing a request takes longer than expected and you need
+     * to extend the lock duration to prevent other workers from picking it up. The lock
+     * expiration time is reset to the current time plus the specified duration.
+     *
+     * @param id - Request ID (obtained from {@link listAndLockHead} or {@link getRequest})
+     * @param options - Lock extension options
+     * @param options.lockSecs - **Required.** New lock duration in seconds from now.
+     * @param options.forefront - If `true`, moves the request to the beginning of the queue when the lock expires. Default is `false`.
+     * @returns Object with new `lockExpiresAt` timestamp
+     * @see https://docs.apify.com/api/v2/request-queue-request-lock-put
+     *
+     * @example
+     * ```javascript
+     * // Lock request for initial processing
+     * const { items } = await client.requestQueue('my-queue').listAndLockHead({ lockSecs: 60, limit: 1 });
+     * const request = items[0];
+     *
+     * // Processing takes longer than expected, extend the lock
+     * await client.requestQueue('my-queue').prolongRequestLock(request.id, { lockSecs: 120 });
+     * ```
      */ async prolongRequestLock(id, options) {
         ow__rspack_import_4_default()(id, (ow__rspack_import_4_default().string));
         ow__rspack_import_4_default()(options, ow__rspack_import_4_default().object.exactShape({
@@ -59284,7 +60486,14 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/request-lock/delete-request-lock
+     * Releases the lock on a request, allowing other clients to process it.
+     *
+     * This should be called after successfully processing a request or when you decide
+     * not to process it.
+     *
+     * @param id - Request ID
+     * @param options - Options such as whether to move to front
+     * @see https://docs.apify.com/api/v2/request-queue-request-lock-delete
      */ async deleteRequestLock(id) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_4_default()(id, (ow__rspack_import_4_default().string));
@@ -59302,7 +60511,14 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/request-collection/list-requests
+     * Lists all requests in the queue.
+     *
+     * Returns a paginated list of all requests, allowing you to iterate through the entire
+     * queue contents.
+     *
+     * @param options - Pagination options
+     * @returns List of requests with pagination information
+     * @see https://docs.apify.com/api/v2/request-queue-requests-get
      */ async listRequests() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_4_default()(options, ow__rspack_import_4_default().object.exactShape({
@@ -59322,7 +60538,13 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2/request-queue-requests-unlock-post
+     * Unlocks all requests locked by this client.
+     *
+     * This is useful for releasing all locks at once, for example when shutting down
+     * a crawler gracefully.
+     *
+     * @returns Number of requests that were unlocked
+     * @see https://docs.apify.com/api/v2/request-queue-requests-unlock-post
      */ async unlockRequests() {
         const response = await this.httpClient.call({
             url: this._url('requests/unlock'),
@@ -59335,12 +60557,21 @@ class RequestQueueClient extends _base_resource_client__rspack_import_2.Resource
         return (0,_utils__rspack_import_3.cast)((0,_utils__rspack_import_3.parseDateFields)((0,_utils__rspack_import_3.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/request-collection/list-requests
+     * Returns an async iterable for paginating through all requests in the queue.
+     *
+     * This allows you to efficiently process all requests using a for-await-of loop,
+     * automatically handling pagination behind the scenes.
+     *
+     * @param options - Pagination options
+     * @returns An async iterable of request pages
+     * @see https://docs.apify.com/api/v2/request-queue-requests-get
      *
-     * Usage:
-     * for await (const { items } of client.paginateRequests({ limit: 10 })) {
-     *   items.forEach((request) => console.log(request));
+     * @example
+     * ```javascript
+     * for await (const { items } of client.requestQueue('my-queue').paginateRequests({ limit: 100 })) {
+     *   items.forEach((request) => console.log(request.url));
      * }
+     * ```
      */ paginateRequests() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_4_default()(options, ow__rspack_import_4_default().object.exactShape({
@@ -59381,15 +60612,34 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class RequestQueueCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Request queues in your account.
+ *
+ * Request queues store URLs to be crawled and their metadata. This client provides methods
+ * to list, create, or get request queues by name.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const queuesClient = client.requestQueues();
+ *
+ * // List all request queues
+ * const { items } = await queuesClient.list();
+ *
+ * // Get or create a request queue by name
+ * const queue = await queuesClient.getOrCreate('my-queue');
+ * ```
+ *
+ * @see https://docs.apify.com/platform/storage/request-queue
+ */ class RequestQueueCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue-collection/get-list-of-request-queues
+     * Lists all Request queues.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -59397,6 +60647,10 @@ class RequestQueueCollectionClient extends _base_resource_collection_client__rsp
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination options.
+     * @returns A paginated iterator of Request queues.
+     * @see https://docs.apify.com/api/v2/request-queues-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -59408,7 +60662,11 @@ class RequestQueueCollectionClient extends _base_resource_collection_client__rsp
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/request-queues/queue-collection/create-request-queue
+     * Gets or creates a Request queue with the specified name.
+     *
+     * @param name - Name of the Request queue. If not provided, a default queue is used.
+     * @returns The Request queue object.
+     * @see https://docs.apify.com/api/v2/request-queues-post
      */ async getOrCreate(name) {
         ow__rspack_import_1_default()(name, (ow__rspack_import_1_default().optional.string));
         return this._getOrCreate(name);
@@ -59449,9 +60707,46 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 const RUN_CHARGE_IDEMPOTENCY_HEADER = 'idempotency-key';
-class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
+/**
+ * Client for managing a specific Actor run.
+ *
+ * Provides methods to get run details, abort, metamorph, resurrect, wait for completion,
+ * and access the run's dataset, key-value store, request queue, and logs.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const runClient = client.run('my-run-id');
+ *
+ * // Get run details
+ * const run = await runClient.get();
+ *
+ * // Wait for the run to finish
+ * const finishedRun = await runClient.waitForFinish();
+ *
+ * // Access the run's dataset
+ * const { items } = await runClient.dataset().listItems();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running/runs-and-builds
+ */ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/run-object/get-run
+     * Gets the Actor run object from the Apify API.
+     *
+     * @param options - Get options
+     * @param options.waitForFinish - Maximum time to wait (in seconds, max 60s) for the run to finish on the API side before returning. Default is 0 (returns immediately).
+     * @returns The ActorRun object, or `undefined` if it does not exist
+     * @see https://docs.apify.com/api/v2/actor-run-get
+     *
+     * @example
+     * ```javascript
+     * // Get run status immediately
+     * const run = await client.run('run-id').get();
+     * console.log(`Status: ${run.status}`);
+     *
+     * // Wait up to 60 seconds for run to finish
+     * const run = await client.run('run-id').get({ waitForFinish: 60 });
+     * ```
      */ async get() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_7_default()(options, ow__rspack_import_7_default().object.exactShape({
@@ -59460,7 +60755,21 @@ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return this._get(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/abort-run/abort-run
+     * Aborts the Actor run.
+     *
+     * @param options - Abort options
+     * @param options.gracefully - If `true`, the Actor run will abort gracefully - it can send status messages and perform cleanup. Default is `false` (immediate abort).
+     * @returns The updated ActorRun object with `ABORTING` or `ABORTED` status
+     * @see https://docs.apify.com/api/v2/actor-run-abort-post
+     *
+     * @example
+     * ```javascript
+     * // Abort immediately
+     * await client.run('run-id').abort();
+     *
+     * // Abort gracefully (allows cleanup)
+     * await client.run('run-id').abort({ gracefully: true });
+     * ```
      */ async abort() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_7_default()(options, ow__rspack_import_7_default().object.exactShape({
@@ -59474,12 +60783,36 @@ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return (0,_utils__rspack_import_2.cast)((0,_utils__rspack_import_2.parseDateFields)((0,_utils__rspack_import_2.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/delete-run/delete-run
+     * Deletes the Actor run.
+     *
+     * @see https://docs.apify.com/api/v2/actor-run-delete
      */ async delete() {
         return this._delete();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/metamorph-run/metamorph-run
+     * Transforms the Actor run into a run of another Actor (metamorph).
+     *
+     * This operation preserves the run ID, storages (dataset, key-value store, request queue),
+     * and resource allocation. The run effectively becomes a run of the target Actor with new input.
+     * This is useful for chaining Actor executions or implementing complex workflows.
+     *
+     * @param targetActorId - ID or username/name of the target Actor
+     * @param input - Input for the target Actor. Can be any JSON-serializable value.
+     * @param options - Metamorph options
+     * @param options.build - Tag or number of the target Actor's build to run. Default is the target Actor's default build.
+     * @param options.contentType - Content type of the input. If specified, input must be a string or Buffer.
+     * @returns The metamorphed ActorRun object (same ID, but now running the target Actor)
+     * @see https://docs.apify.com/api/v2/actor-run-metamorph-post
+     *
+     * @example
+     * ```javascript
+     * // Transform current run into another Actor
+     * const metamorphedRun = await client.run('original-run-id').metamorph(
+     *   'target-actor-id',
+     *   { url: 'https://example.com' }
+     * );
+     * console.log(`Run ${metamorphedRun.id} is now running ${metamorphedRun.actId}`);
+     * ```
      */ async metamorph(targetActorId, input) {
         let options = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : {};
         ow__rspack_import_7_default()(targetActorId, (ow__rspack_import_7_default().string));
@@ -59513,7 +60846,19 @@ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return (0,_utils__rspack_import_2.cast)((0,_utils__rspack_import_2.parseDateFields)((0,_utils__rspack_import_2.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/reboot-run/reboot-run
+     * Reboots the Actor run.
+     *
+     * Rebooting restarts the Actor's Docker container while preserving the run ID and storages.
+     * This can be useful to recover from certain errors or to force the Actor to restart
+     * with a fresh environment.
+     *
+     * @returns The updated ActorRun object
+     * @see https://docs.apify.com/api/v2/actor-run-reboot-post
+     *
+     * @example
+     * ```javascript
+     * const run = await client.run('run-id').reboot();
+     * ```
      */ async reboot() {
         const request = {
             url: this._url('reboot'),
@@ -59522,12 +60867,48 @@ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
         const response = await this.httpClient.call(request);
         return (0,_utils__rspack_import_2.cast)((0,_utils__rspack_import_2.parseDateFields)((0,_utils__rspack_import_2.pluckData)(response.data)));
     }
-    async update(newFields) {
+    /**
+     * Updates the Actor run with specified fields.
+     *
+     * @param newFields - Fields to update
+     * @param newFields.statusMessage - Custom status message to display (e.g., "Processing page 10/100")
+     * @param newFields.isStatusMessageTerminal - If `true`, the status message is final and won't be overwritten. Default is `false`.
+     * @param newFields.generalAccess - General resource access level ('FOLLOW_USER_SETTING', 'ANYONE_WITH_ID_CAN_READ' or 'RESTRICTED')
+     * @returns The updated ActorRun object
+     *
+     * @example
+     * ```javascript
+     * // Set a status message
+     * await client.run('run-id').update({
+     *   statusMessage: 'Processing items: 50/100'
+     * });
+     * ```
+     */ async update(newFields) {
         ow__rspack_import_7_default()(newFields, (ow__rspack_import_7_default().object));
         return this._update(newFields);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/resurrect-run/resurrect-run
+     * Resurrects a finished Actor run, starting it again with the same settings.
+     *
+     * This creates a new run with the same configuration as the original run. The original
+     * run's storages (dataset, key-value store, request queue) are preserved and reused.
+     *
+     * @param options - Resurrection options (override original run settings)
+     * @param options.build - Tag or number of the build to use. If not provided, uses the original run's build.
+     * @param options.memory - Memory in megabytes. If not provided, uses the original run's memory.
+     * @param options.timeout - Timeout in seconds. If not provided, uses the original run's timeout.
+     * @param options.maxItems - Maximum number of dataset items (pay-per-result Actors).
+     * @param options.maxTotalChargeUsd - Maximum cost in USD (pay-per-event Actors).
+     * @param options.restartOnError - Whether to restart on error.
+     * @returns The new (resurrected) ActorRun object
+     * @see https://docs.apify.com/api/v2/post-resurrect-run
+     *
+     * @example
+     * ```javascript
+     * // Resurrect a failed run with more memory
+     * const newRun = await client.run('failed-run-id').resurrect({ memory: 2048 });
+     * console.log(`New run started: ${newRun.id}`);
+     * ```
      */ async resurrect() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_7_default()(options, ow__rspack_import_7_default().object.exactShape({
@@ -59546,7 +60927,14 @@ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return (0,_utils__rspack_import_2.cast)((0,_utils__rspack_import_2.parseDateFields)((0,_utils__rspack_import_2.pluckData)(response.data)));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/charge-events-in-run
+     * Charges the Actor run for a specific event.
+     *
+     * @param options - Charge options including event name and count.
+     * @param options.eventName - **Required.** Name of the event to charge for.
+     * @param options.count - Number of times to charge the event. Default is 1.
+     * @param options.idempotencyKey - Optional key to ensure the charge is not duplicated. If not provided, one is auto-generated.
+     * @returns Empty response object.
+     * @see https://docs.apify.com/api/v2/post-charge-run
      */ async charge(options) {
         ow__rspack_import_7_default()(options, ow__rspack_import_7_default().object.exactShape({
             eventName: (ow__rspack_import_7_default().string),
@@ -59571,16 +60959,32 @@ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return response;
     }
     /**
-     * Returns a promise that resolves with the finished Run object when the provided actor run finishes
-     * or with the unfinished Run object when the `waitSecs` timeout lapses. The promise is NOT rejected
-     * based on run status. You can inspect the `status` property of the Run object to find out its status.
+     * Waits for the Actor run to finish and returns the finished Run object.
      *
-     * The difference between this function and the `waitForFinish` parameter of the `get` method
-     * is the fact that this function can wait indefinitely. Its use is preferable to the
-     * `waitForFinish` parameter alone, which it uses internally.
+     * The promise resolves when the run reaches a terminal state (`SUCCEEDED`, `FAILED`, `ABORTED`, or `TIMED-OUT`).
+     * If `waitSecs` is provided and the timeout is reached, the promise resolves with the unfinished
+     * Run object (status will be `RUNNING` or `READY`). The promise is NOT rejected based on run status.
      *
-     * This is useful when you need to chain actor executions. Similar effect can be achieved
-     * by using webhooks, so be sure to review which technique fits your use-case better.
+     * Unlike the `waitForFinish` parameter in {@link get}, this method can wait indefinitely
+     * by polling the run status. It uses the `waitForFinish` parameter internally (max 60s per call)
+     * and continuously polls until the run finishes or the timeout is reached.
+     *
+     * @param options - Wait options
+     * @param options.waitSecs - Maximum time to wait for the run to finish, in seconds. If the limit is reached, the returned promise resolves to a run object that will have status `READY` or `RUNNING`. If omitted, waits indefinitely.
+     * @returns The ActorRun object (finished or still running if timeout was reached)
+     *
+     * @example
+     * ```javascript
+     * // Wait indefinitely for run to finish
+     * const run = await client.run('run-id').waitForFinish();
+     * console.log(`Run finished with status: ${run.status}`);
+     *
+     * // Wait up to 5 minutes
+     * const run = await client.run('run-id').waitForFinish({ waitSecs: 300 });
+     * if (run.status === 'SUCCEEDED') {
+     *   console.log('Run succeeded!');
+     * }
+     * ```
      */ async waitForFinish() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_7_default()(options, ow__rspack_import_7_default().object.exactShape({
@@ -59589,40 +60993,65 @@ class RunClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return this._waitForFinish(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/run-object-and-its-storages
+     * Returns a client for the default dataset of this Actor run.
+     *
+     * @returns A client for accessing the run's default dataset
+     * @see https://docs.apify.com/api/v2/actor-run-get
      *
-     * This also works through `actorClient.lastRun().dataset()`.
-     * https://docs.apify.com/api/v2#/reference/actors/last-run-object-and-its-storages
+     * @example
+     * ```javascript
+     * // Access run's dataset
+     * const { items } = await client.run('run-id').dataset().listItems();
+     * ```
      */ dataset() {
         return new _dataset__rspack_import_3.DatasetClient(this._subResourceOptions({
             resourcePath: 'dataset'
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/run-object-and-its-storages
+     * Returns a client for the default key-value store of this Actor run.
      *
-     * This also works through `actorClient.lastRun().keyValueStore()`.
-     * https://docs.apify.com/api/v2#/reference/actors/last-run-object-and-its-storages
+     * @returns A client for accessing the run's default key-value store
+     * @see https://docs.apify.com/api/v2/actor-run-get
+     *
+     * @example
+     * ```javascript
+     * // Access run's key-value store
+     * const output = await client.run('run-id').keyValueStore().getRecord('OUTPUT');
+     * ```
      */ keyValueStore() {
         return new _key_value_store__rspack_import_4.KeyValueStoreClient(this._subResourceOptions({
             resourcePath: 'key-value-store'
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/run-object-and-its-storages
+     * Returns a client for the default Request queue of this Actor run.
+     *
+     * @returns A client for accessing the run's default Request queue
+     * @see https://docs.apify.com/api/v2/actor-run-get
      *
-     * This also works through `actorClient.lastRun().requestQueue()`.
-     * https://docs.apify.com/api/v2#/reference/actors/last-run-object-and-its-storages
+     * @example
+     * ```javascript
+     * // Access run's Request queue
+     * const { items } = await client.run('run-id').requestQueue().listHead();
+     * ```
      */ requestQueue() {
         return new _request_queue__rspack_import_6.RequestQueueClient(this._subResourceOptions({
             resourcePath: 'request-queue'
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-runs/run-object-and-its-storages
+     * Returns a client for accessing the log of this Actor run.
+     *
+     * @returns A client for accessing the run's log
+     * @see https://docs.apify.com/api/v2/actor-run-get
      *
-     * This also works through `actorClient.lastRun().log()`.
-     * https://docs.apify.com/api/v2#/reference/actors/last-run-object-and-its-storages
+     * @example
+     * ```javascript
+     * // Get run log
+     * const log = await client.run('run-id').log().get();
+     * console.log(log);
+     * ```
      */ log() {
         return new _log__rspack_import_5.LogClient(this._subResourceOptions({
             resourcePath: 'log'
@@ -59689,15 +61118,35 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class RunCollectionClient extends _base_resource_collection_client__rspack_import_1.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Actor runs.
+ *
+ * Provides methods to list Actor runs across all Actors or for a specific Actor.
+ * To access an individual run, use the `run()` method on the main ApifyClient.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ *
+ * // List all runs
+ * const runsClient = client.runs();
+ * const { items } = await runsClient.list();
+ *
+ * // List runs for a specific Actor
+ * const actorRunsClient = client.actor('my-actor-id').runs();
+ * const { items: actorRuns } = await actorRunsClient.list();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running/runs-and-builds
+ */ class RunCollectionClient extends _base_resource_collection_client__rspack_import_1.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actors/run-collection/get-list-of-runs
+     * Lists all Actor runs.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -59705,6 +61154,10 @@ class RunCollectionClient extends _base_resource_collection_client__rspack_impor
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination and filtering options.
+     * @returns A paginated iterator of Actor runs.
+     * @see https://docs.apify.com/api/v2/actor-runs-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_2_default()(options, ow__rspack_import_2_default().object.exactShape({
@@ -59743,25 +61196,59 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class ScheduleClient extends _base_resource_client__rspack_import_0.ResourceClient {
+/**
+ * Client for managing a specific Schedule.
+ *
+ * Schedules are used to automatically start Actors or tasks at specified times. This client provides
+ * methods to get, update, and delete schedules, as well as retrieve schedule logs.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const scheduleClient = client.schedule('my-schedule-id');
+ *
+ * // Get schedule details
+ * const schedule = await scheduleClient.get();
+ *
+ * // Update schedule
+ * await scheduleClient.update({
+ *   cronExpression: '0 12 * * *',
+ *   isEnabled: true
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/schedules
+ */ class ScheduleClient extends _base_resource_client__rspack_import_0.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedule-object/get-schedule
+     * Retrieves the schedule.
+     *
+     * @returns The schedule object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/schedule-get
      */ async get() {
         return this._get();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedule-object/update-schedule
+     * Updates the schedule with the specified fields.
+     *
+     * @param newFields - Fields to update.
+     * @returns The updated schedule object.
+     * @see https://docs.apify.com/api/v2/schedule-put
      */ async update(newFields) {
         ow__rspack_import_2_default()(newFields, (ow__rspack_import_2_default().object));
         return this._update(newFields);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedule-object/delete-schedule
+     * Deletes the schedule.
+     *
+     * @see https://docs.apify.com/api/v2/schedule-delete
      */ async delete() {
         return this._delete();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedule-log/get-schedule-log
+     * Retrieves the schedule's log.
+     *
+     * @returns The schedule log as a string, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/schedule-log-get
      */ async getLog() {
         const requestOpts = {
             url: this._url('log'),
@@ -59785,7 +61272,9 @@ class ScheduleClient extends _base_resource_client__rspack_import_0.ResourceClie
         });
     }
 }
-var ScheduleActions = /*#__PURE__*/ function(ScheduleActions) {
+/**
+ * Types of actions that can be scheduled.
+ */ var ScheduleActions = /*#__PURE__*/ function(ScheduleActions) {
     ScheduleActions["RunActor"] = "RUN_ACTOR";
     ScheduleActions["RunActorTask"] = "RUN_ACTOR_TASK";
     return ScheduleActions;
@@ -59804,15 +61293,38 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class ScheduleCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Schedules in your account.
+ *
+ * Schedules are used to automatically start Actors or tasks at specified times.
+ * This client provides methods to list and create schedules.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const schedulesClient = client.schedules();
+ *
+ * // List all schedules
+ * const { items } = await schedulesClient.list();
+ *
+ * // Create a new schedule
+ * const newSchedule = await schedulesClient.create({
+ *   actorId: 'my-actor-id',
+ *   cronExpression: '0 9 * * *',
+ *   isEnabled: true
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/schedules
+ */ class ScheduleCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedules-collection/get-list-of-schedules
+     * Lists all schedules.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -59820,6 +61332,10 @@ class ScheduleCollectionClient extends _base_resource_collection_client__rspack_
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination and sorting options.
+     * @returns A paginated iterator of schedules.
+     * @see https://docs.apify.com/api/v2/schedules-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -59830,7 +61346,11 @@ class ScheduleCollectionClient extends _base_resource_collection_client__rspack_
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/schedules/schedules-collection/create-schedule
+     * Creates a new schedule.
+     *
+     * @param schedule - The schedule data.
+     * @returns The created schedule object.
+     * @see https://docs.apify.com/api/v2/schedules-post
      */ async create(schedule) {
         ow__rspack_import_1_default()(schedule, (ow__rspack_import_1_default().optional.object));
         return this._create(schedule);
@@ -59858,15 +61378,34 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class StoreCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for browsing Actors in the Apify Store.
+ *
+ * The Apify Store contains publicly available Actors that can be used by anyone.
+ * This client provides methods to search and list Actors from the Store.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient();
+ * const storeClient = client.store();
+ *
+ * // Search for Actors in the Store
+ * const { items } = await storeClient.list({ search: 'web scraper' });
+ *
+ * // Get details about a specific Store Actor
+ * const actor = await storeClient.list({ username: 'apify', actorName: 'web-scraper' });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/publishing
+ */ class StoreCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2/#/reference/store/store-actors-collection/get-list-of-actors-in-store
+     * Lists Actors from the Apify Store.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -59874,6 +61413,10 @@ class StoreCollectionClient extends _base_resource_collection_client__rspack_imp
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Search and pagination options.
+     * @returns A paginated iterator of store Actors.
+     * @see https://docs.apify.com/api/v2/store-actors-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -59920,26 +61463,66 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class TaskClient extends _base_resource_client__rspack_import_1.ResourceClient {
+/**
+ * Client for managing a specific Actor task.
+ *
+ * Tasks are pre-configured Actor runs with saved input and options. This client provides methods
+ * to start, call, update, and delete tasks, as well as manage their runs and webhooks.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const taskClient = client.task('my-task-id');
+ *
+ * // Start a task
+ * const run = await taskClient.start();
+ *
+ * // Call a task and wait for it to finish
+ * const finishedRun = await taskClient.call();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running/tasks
+ */ class TaskClient extends _base_resource_client__rspack_import_1.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-object/get-task
+     * Retrieves the Actor task.
+     *
+     * @returns The task object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/actor-task-get
      */ async get() {
         return this._get();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-object/update-task
+     * Updates the task with the specified fields.
+     *
+     * @param newFields - Fields to update.
+     * @returns The updated task object.
+     * @see https://docs.apify.com/api/v2/actor-task-put
      */ async update(newFields) {
         ow__rspack_import_6_default()(newFields, (ow__rspack_import_6_default().object));
         return this._update(newFields);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-object/delete-task
+     * Deletes the Task.
+     *
+     * @see https://docs.apify.com/api/v2/actor-task-delete
      */ async delete() {
         return this._delete();
     }
     /**
-     * Starts a task and immediately returns the Run object.
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
+     * Starts an Actor task and immediately returns the Run object.
+     *
+     * @param input - Input overrides for the task. If not provided, the task's saved input is used.
+     * @param options - Run options.
+     * @param options.build - Tag or number of the Actor build to run (e.g., `'beta'` or `'1.2.345'`).
+     * @param options.memory - Memory in megabytes allocated for the run.
+     * @param options.timeout - Timeout for the run in seconds. Zero means no timeout.
+     * @param options.waitForFinish - Maximum time to wait (in seconds, max 60s) for the run to finish before returning.
+     * @param options.webhooks - Webhooks to trigger for specific Actor run events.
+     * @param options.maxItems - Maximum number of dataset items (for pay-per-result Actors).
+     * @param options.maxTotalChargeUsd - Maximum cost in USD (for pay-per-event Actors).
+     * @param options.restartOnError - Whether to restart the run on error.
+     * @returns The Actor Run object.
+     * @see https://docs.apify.com/api/v2/actor-task-runs-post
      */ async start(input) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_6_default()(input, (ow__rspack_import_6_default().optional.object));
@@ -59982,7 +61565,19 @@ class TaskClient extends _base_resource_client__rspack_import_1.ResourceClient {
     /**
      * Starts a task and waits for it to finish before returning the Run object.
      * It waits indefinitely, unless the `waitSecs` option is provided.
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection/run-task
+     *
+     * @param input - Input overrides for the task. If not provided, the task's saved input is used.
+     * @param options - Run and wait options.
+     * @param options.build - Tag or number of the Actor build to run.
+     * @param options.memory - Memory in megabytes allocated for the run.
+     * @param options.timeout - Timeout for the run in seconds.
+     * @param options.waitSecs - Maximum time to wait for the run to finish, in seconds. If omitted, waits indefinitely.
+     * @param options.webhooks - Webhooks to trigger for specific Actor run events.
+     * @param options.maxItems - Maximum number of dataset items (for pay-per-result Actors).
+     * @param options.maxTotalChargeUsd - Maximum cost in USD (for pay-per-event Actors).
+     * @param options.restartOnError - Whether to restart the run on error.
+     * @returns The Actor run object.
+     * @see https://docs.apify.com/api/v2/actor-task-runs-post
      */ async call(input) {
         let options = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : {};
         ow__rspack_import_6_default()(input, (ow__rspack_import_6_default().optional.object));
@@ -60006,7 +61601,10 @@ class TaskClient extends _base_resource_client__rspack_import_1.ResourceClient {
         });
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-input-object/get-task-input
+     * Retrieves the Actor task's input object.
+     *
+     * @returns The Task's input, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/actor-task-input-get
      */ async getInput() {
         const requestOpts = {
             url: this._url('input'),
@@ -60022,7 +61620,11 @@ class TaskClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return undefined;
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-input-object/update-task-input
+     * Updates the Actor task's input object.
+     *
+     * @param newFields - New input data for the task.
+     * @returns The updated task input.
+     * @see https://docs.apify.com/api/v2/actor-task-input-put
      */ async updateInput(newFields) {
         const response = await this.httpClient.call({
             url: this._url('input'),
@@ -60033,7 +61635,13 @@ class TaskClient extends _base_resource_client__rspack_import_1.ResourceClient {
         return (0,_utils__rspack_import_2.cast)(response.data);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/last-run-object-and-its-storages
+     * Returns a client for the last run of this task.
+     *
+     * @param options - Filter options for the last run.
+     * @param options.status - Filter by run status (e.g., `'SUCCEEDED'`, `'FAILED'`, `'RUNNING'`).
+     * @param options.origin - Filter by run origin (e.g., `'WEB'`, `'API'`, `'SCHEDULE'`).
+     * @returns A client for the last run.
+     * @see https://docs.apify.com/api/v2/actor-task-runs-last-get
      */ lastRun() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_6_default()(options, ow__rspack_import_6_default().object.exactShape({
@@ -60047,14 +61655,20 @@ class TaskClient extends _base_resource_client__rspack_import_1.ResourceClient {
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/run-collection
+     * Returns a client for the Runs of this Task.
+     *
+     * @returns A client for the task's runs.
+     * @see https://docs.apify.com/api/v2/actor-task-runs-get
      */ runs() {
         return new _run_collection__rspack_import_4.RunCollectionClient(this._subResourceOptions({
             resourcePath: 'runs'
         }));
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/webhook-collection
+     * Returns a client for the Webhooks of this Task.
+     *
+     * @returns A client for the task's webhooks.
+     * @see https://docs.apify.com/api/v2/actor-task-webhooks-get
      */ webhooks() {
         return new _webhook_collection__rspack_import_5.WebhookCollectionClient(this._subResourceOptions());
     }
@@ -60081,20 +61695,38 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class TaskCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Actor tasks in your account.
+ *
+ * Tasks are pre-configured Actor runs with saved input and options. This client provides
+ * methods to list and create tasks.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const tasksClient = client.tasks();
+ *
+ * // List all tasks
+ * const { items } = await tasksClient.list();
+ *
+ * // Create a new task
+ * const newTask = await tasksClient.create({
+ *   actId: 'my-actor-id',
+ *   name: 'my-task',
+ *   input: { url: 'https://example.com' }
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running/tasks
+ */ class TaskCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-collection/get-list-of-tasks
-     * @param {object} [options]
-     * @param {number} [options.limit]
-     * @param {number} [options.offset]
-     * @param {boolean} [options.desc]
-     * @return {PaginatedIterator<TaskList>}
+     * Lists all Tasks.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -60102,6 +61734,10 @@ class TaskCollectionClient extends _base_resource_collection_client__rspack_impo
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination and sorting options.
+     * @returns A paginated iterator of tasks.
+     * @see https://docs.apify.com/api/v2/actor-tasks-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -60112,7 +61748,11 @@ class TaskCollectionClient extends _base_resource_collection_client__rspack_impo
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/actor-tasks/task-collection/create-task
+     * Creates a new task.
+     *
+     * @param task - The task data.
+     * @returns The created task object.
+     * @see https://docs.apify.com/api/v2/actor-tasks-post
      */ async create(task) {
         ow__rspack_import_1_default()(task, (ow__rspack_import_1_default().object));
         return this._create(task);
@@ -60140,16 +61780,46 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _utils__rspack_import_1 = __webpack_require__("./src/utils.ts");
 
 
-class UserClient extends _base_resource_client__rspack_import_0.ResourceClient {
+/**
+ * Client for managing user account information.
+ *
+ * Provides methods to retrieve user details, monthly usage statistics, and account limits.
+ * When using an API token, you can access your own user information or public information
+ * about other users.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const userClient = client.user('my-user-id');
+ *
+ * // Get user information
+ * const user = await userClient.get();
+ *
+ * // Get monthly usage
+ * const usage = await userClient.monthlyUsage();
+ *
+ * // Get account limits
+ * const limits = await userClient.limits();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/actors/running
+ */ class UserClient extends _base_resource_client__rspack_import_0.ResourceClient {
     /**
+     * Retrieves the user data.
+     *
      * Depending on whether ApifyClient was created with a token,
      * the method will either return public or private user data.
-     * https://docs.apify.com/api/v2#/reference/users
+     *
+     * @returns The user object.
+     * @see https://docs.apify.com/api/v2/user-get
      */ async get() {
         return this._get();
     }
     /**
-     * https://docs.apify.com/api/v2/#/reference/users/monthly-usage
+     * Retrieves the user's monthly usage data.
+     *
+     * @returns The monthly usage object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/user-usage-monthly-get
      */ async monthlyUsage() {
         const requestOpts = {
             url: this._url('usage/monthly'),
@@ -60166,7 +61836,10 @@ class UserClient extends _base_resource_client__rspack_import_0.ResourceClient {
         return undefined;
     }
     /**
-     * https://docs.apify.com/api/v2/#/reference/users/account-and-usage-limits
+     * Retrieves the user's account and usage limits.
+     *
+     * @returns The account and usage limits object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/user-limits-get
      */ async limits() {
         const requestOpts = {
             url: this._url('limits'),
@@ -60182,7 +61855,10 @@ class UserClient extends _base_resource_client__rspack_import_0.ResourceClient {
         return undefined;
     }
     /**
-     * https://docs.apify.com/api/v2/#/reference/users/account-and-usage-limits
+     * Updates the user's account and usage limits.
+     *
+     * @param options - The new limits to set.
+     * @see https://docs.apify.com/api/v2/user-limits-put
      */ async updateLimits(options) {
         const requestOpts = {
             url: this._url('limits'),
@@ -60229,25 +61905,64 @@ __webpack_require__.d(__webpack_exports__, {
 
 
 
-class WebhookClient extends _base_resource_client__rspack_import_0.ResourceClient {
+/**
+ * Client for managing a specific webhook.
+ *
+ * Webhooks allow you to receive notifications when specific events occur in your Actors or tasks.
+ * This client provides methods to get, update, delete, and test webhooks, as well as retrieve
+ * webhook dispatches.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const webhookClient = client.webhook('my-webhook-id');
+ *
+ * // Get webhook details
+ * const webhook = await webhookClient.get();
+ *
+ * // Update webhook
+ * await webhookClient.update({
+ *   isEnabled: true,
+ *   eventTypes: ['ACTOR.RUN.SUCCEEDED'],
+ *   requestUrl: 'https://example.com/webhook'
+ * });
+ *
+ * // Test webhook
+ * await webhookClient.test();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/integrations/webhooks
+ */ class WebhookClient extends _base_resource_client__rspack_import_0.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-object/get-webhook
+     * Retrieves the webhook.
+     *
+     * @returns The webhook object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/webhook-get
      */ async get() {
         return this._get();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-object/update-webhook
+     * Updates the webhook with the specified fields.
+     *
+     * @param newFields - Fields to update.
+     * @returns The updated webhook object.
+     * @see https://docs.apify.com/api/v2/webhook-put
      */ async update(newFields) {
         ow__rspack_import_3_default()(newFields, (ow__rspack_import_3_default().object));
         return this._update(newFields);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-object/delete-webhook
+     * Deletes the webhook.
+     *
+     * @see https://docs.apify.com/api/v2/webhook-delete
      */ async delete() {
         return this._delete();
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-test/test-webhook
+     * Tests the webhook by dispatching a test event.
+     *
+     * @returns The webhook dispatch object, or `undefined` if the test fails.
+     * @see https://docs.apify.com/api/v2/webhook-test-post
      */ async test() {
         const request = {
             url: this._url('test'),
@@ -60263,7 +61978,10 @@ class WebhookClient extends _base_resource_client__rspack_import_0.ResourceClien
         return undefined;
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/dispatches-collection
+     * Returns a client for the dispatches of this webhook.
+     *
+     * @returns A client for the webhook's dispatches.
+     * @see https://docs.apify.com/api/v2/webhook-webhook-dispatches-get
      */ dispatches() {
         return new _webhook_dispatch_collection__rspack_import_2.WebhookDispatchCollectionClient(this._subResourceOptions({
             resourcePath: 'dispatches'
@@ -60292,15 +62010,37 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class WebhookCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of Webhooks.
+ *
+ * Webhooks allow you to receive notifications when specific events occur in your Actors or tasks.
+ * This client provides methods to list and create webhooks for specific Actors or tasks.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ *
+ * // List webhooks for an Actor
+ * const actorWebhooksClient = client.actor('my-actor-id').webhooks();
+ * const { items } = await actorWebhooksClient.list();
+ *
+ * // Create a webhook
+ * const newWebhook = await actorWebhooksClient.create({
+ *   eventTypes: ['ACTOR.RUN.SUCCEEDED'],
+ *   requestUrl: 'https://example.com/webhook'
+ * });
+ * ```
+ *
+ * @see https://docs.apify.com/platform/integrations/webhooks
+ */ class WebhookCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-collection/get-list-of-webhooks
+     * Lists all Webhooks.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -60308,6 +62048,10 @@ class WebhookCollectionClient extends _base_resource_collection_client__rspack_i
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination and sorting options.
+     * @returns A paginated iterator of webhooks.
+     * @see https://docs.apify.com/api/v2/webhooks-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -60318,7 +62062,11 @@ class WebhookCollectionClient extends _base_resource_collection_client__rspack_i
         return this._listPaginated(options);
     }
     /**
-     * https://docs.apify.com/api/v2#/reference/webhooks/webhook-collection/create-webhook
+     * Creates a new webhook.
+     *
+     * @param webhook - The webhook data.
+     * @returns The created webhook object.
+     * @see https://docs.apify.com/api/v2/webhooks-post
      */ async create(webhook) {
         ow__rspack_import_1_default()(webhook, (ow__rspack_import_1_default().optional.object));
         return this._create(webhook);
@@ -60344,9 +62092,29 @@ __webpack_require__.d(__webpack_exports__, {
 });
 /* import */ var _base_resource_client__rspack_import_0 = __webpack_require__("./src/base/resource_client.ts");
 
-class WebhookDispatchClient extends _base_resource_client__rspack_import_0.ResourceClient {
+/**
+ * Client for managing a specific webhook dispatch.
+ *
+ * Webhook dispatches represent individual notifications sent by webhooks. This client provides
+ * methods to retrieve details about a specific dispatch.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const webhookClient = client.webhook('my-webhook-id');
+ *
+ * // Get a specific dispatch
+ * const dispatchClient = webhookClient.dispatches().get('dispatch-id');
+ * const dispatch = await dispatchClient.get();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/integrations/webhooks
+ */ class WebhookDispatchClient extends _base_resource_client__rspack_import_0.ResourceClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/webhook-dispatches/webhook-dispatch-object/get-webhook-dispatch
+     * Retrieves the webhook dispatch.
+     *
+     * @returns The webhook dispatch object, or `undefined` if it does not exist.
+     * @see https://docs.apify.com/api/v2/webhook-dispatch-get
      */ async get() {
         return this._get();
     }
@@ -60379,15 +62147,32 @@ __webpack_require__.d(__webpack_exports__, {
 /* import */ var _base_resource_collection_client__rspack_import_0 = __webpack_require__("./src/base/resource_collection_client.ts");
 
 
-class WebhookDispatchCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
+/**
+ * Client for managing the collection of webhook dispatches.
+ *
+ * Webhook dispatches represent individual notifications sent by a webhook. This client provides
+ * methods to list all dispatches for a specific webhook.
+ *
+ * @example
+ * ```javascript
+ * const client = new ApifyClient({ token: 'my-token' });
+ * const webhookClient = client.webhook('my-webhook-id');
+ *
+ * // List all dispatches for this webhook
+ * const dispatchesClient = webhookClient.dispatches();
+ * const { items } = await dispatchesClient.list();
+ * ```
+ *
+ * @see https://docs.apify.com/platform/integrations/webhooks
+ */ class WebhookDispatchCollectionClient extends _base_resource_collection_client__rspack_import_0.ResourceCollectionClient {
     /**
-     * https://docs.apify.com/api/v2#/reference/webhook-dispatches/webhook-dispatches-collection/get-list-of-webhook-dispatches
+     * Lists all webhook dispatches.
      *
      * Awaiting the return value (as you would with a Promise) will result in a single API call. The amount of fetched
      * items in a single API call is limited.
      * ```javascript
      * const paginatedList = await client.list(options);
-     *```
+     * ```
      *
      * Asynchronous iteration is also supported. This will fetch additional pages if needed until all items are
      * retrieved.
@@ -60395,6 +62180,10 @@ class WebhookDispatchCollectionClient extends _base_resource_collection_client__
      * ```javascript
      * for await (const singleItem of client.list(options)) {...}
      * ```
+     *
+     * @param options - Pagination and sorting options.
+     * @returns A paginated iterator of webhook dispatches.
+     * @see https://docs.apify.com/api/v2/webhook-dispatches-get
      */ list() {
         let options = arguments.length > 0 && arguments[0] !== void 0 ? arguments[0] : {};
         ow__rspack_import_1_default()(options, ow__rspack_import_1_default().object.exactShape({
@@ -60616,7 +62405,7 @@ function isStream(value) {
 function getVersionData() {
     if (true) {
         return {
-            version: "2.20.1-beta.6"
+            version: "2.20.1-beta.8"
         };
     }
     // eslint-disable-next-line
@@ -70527,7 +72316,7 @@ module.exports = JSON.parse('{"name":"escodegen","description":"ECMAScript code
 }),
 "./package.json": (function (module) {
 "use strict";
-module.exports = JSON.parse('{"name":"apify-client","version":"2.20.1-beta.6","description":"Apify API client for JavaScript","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","browser":"dist/bundle.js","unpkg":"dist/bundle.js","exports":{"./package.json":"./package.json",".":{"import":"./dist/index.mjs","require":"./dist/index.js","types":"./dist/index.d.ts","browser":"./dist/bundle.js"}},"keywords":["apify","api","apifier","crawler","scraper"],"author":{"name":"Apify","email":"support@apify.com","url":"https://apify.com"},"contributors":["Jan Curn <jan@apify.com>","Marek Trunkát <marek@apify.com>","Ondra Urban <ondra@apify.com>","Jakub Drobník <jakub.drobnik@apify.com>"],"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/apify/apify-client-js"},"bugs":{"url":"https://github.com/apify/apify-client-js/issues"},"homepage":"https://docs.apify.com/api/client/js/","files":["dist","!dist/*.tsbuildinfo"],"scripts":{"build":"npm run clean && npm run build:node && npm run build:browser","postbuild":"gen-esm-wrapper dist/index.js dist/index.mjs","prepublishOnly":"(test $CI || (echo \\"Publishing is reserved to CI!\\"; exit 1))","clean":"rimraf dist","test":"npm run build && jest","lint":"eslint","lint:fix":"eslint --fix","tsc-check-tests":"tsc --noEmit --project test/tsconfig.json","format":"prettier --write .","format:check":"prettier --check .","build:node":"tsc","build:browser":"rsbuild build"},"dependencies":{"@apify/consts":"^2.42.0","@apify/log":"^2.2.6","@apify/utilities":"^2.23.2","@crawlee/types":"^3.3.0","ansi-colors":"^4.1.1","async-retry":"^1.3.3","axios":"^1.6.7","content-type":"^1.0.5","ow":"^0.28.2","proxy-agent":"^6.5.0","tslib":"^2.5.0","type-fest":"^4.0.0"},"devDependencies":{"@apify/eslint-config":"^1.0.0","@apify/tsconfig":"^0.1.1","@babel/cli":"^7.21.0","@babel/core":"^7.21.0","@babel/preset-env":"^7.20.2","@babel/register":"^7.21.0","@crawlee/puppeteer":"^3.2.2","@rsbuild/core":"^1.3.6","@rsbuild/plugin-node-polyfill":"^1.3.0","@stylistic/eslint-plugin-ts":"^4.2.0","@types/async-retry":"^1.4.5","@types/content-type":"^1.1.5","@types/express":"^5.0.0","@types/fs-extra":"^11.0.1","@types/jest":"^29.4.0","@types/node":"^24.0.0","ajv":"^8.17.1","babel-loader":"^10.0.0","body-parser":"^1.20.3","compression":"^1.7.4","eslint":"^9.24.0","eslint-config-prettier":"^10.1.2","express":"^5.0.0","fs-extra":"^11.1.0","gen-esm-wrapper":"^1.1.2","globals":"^16.0.0","jest":"^29.4.3","prettier":"^3.5.3","process":"^0.11.10","puppeteer":"^24.0.0","rimraf":"^6.0.0","source-map-support":"^0.5.21","ts-jest":"^29.0.5","ts-loader":"^9.4.2","ts-node":"^10.9.1","typescript":"^5.8.3","typescript-eslint":"^8.29.1"},"packageManager":"npm@10.9.2"}')
+module.exports = JSON.parse('{"name":"apify-client","version":"2.20.1-beta.8","description":"Apify API client for JavaScript","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","browser":"dist/bundle.js","unpkg":"dist/bundle.js","exports":{"./package.json":"./package.json",".":{"import":"./dist/index.mjs","require":"./dist/index.js","types":"./dist/index.d.ts","browser":"./dist/bundle.js"}},"keywords":["apify","api","apifier","crawler","scraper"],"author":{"name":"Apify","email":"support@apify.com","url":"https://apify.com"},"contributors":["Jan Curn <jan@apify.com>","Marek Trunkát <marek@apify.com>","Ondra Urban <ondra@apify.com>","Jakub Drobník <jakub.drobnik@apify.com>"],"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/apify/apify-client-js"},"bugs":{"url":"https://github.com/apify/apify-client-js/issues"},"homepage":"https://docs.apify.com/api/client/js/","files":["dist","!dist/*.tsbuildinfo"],"scripts":{"build":"npm run clean && npm run build:node && npm run build:browser","postbuild":"gen-esm-wrapper dist/index.js dist/index.mjs","prepublishOnly":"(test $CI || (echo \\"Publishing is reserved to CI!\\"; exit 1))","clean":"rimraf dist","test":"npm run build && jest","lint":"eslint","lint:fix":"eslint --fix","tsc-check-tests":"tsc --noEmit --project test/tsconfig.json","format":"prettier --write .","format:check":"prettier --check .","build:node":"tsc","build:browser":"rsbuild build"},"dependencies":{"@apify/consts":"^2.42.0","@apify/log":"^2.2.6","@apify/utilities":"^2.23.2","@crawlee/types":"^3.3.0","ansi-colors":"^4.1.1","async-retry":"^1.3.3","axios":"^1.6.7","content-type":"^1.0.5","ow":"^0.28.2","proxy-agent":"^6.5.0","tslib":"^2.5.0","type-fest":"^4.0.0"},"devDependencies":{"@apify/eslint-config":"^1.0.0","@apify/tsconfig":"^0.1.1","@babel/cli":"^7.21.0","@babel/core":"^7.21.0","@babel/preset-env":"^7.20.2","@babel/register":"^7.21.0","@crawlee/puppeteer":"^3.2.2","@rsbuild/core":"^1.3.6","@rsbuild/plugin-node-polyfill":"^1.3.0","@stylistic/eslint-plugin-ts":"^4.2.0","@types/async-retry":"^1.4.5","@types/content-type":"^1.1.5","@types/express":"^5.0.0","@types/fs-extra":"^11.0.1","@types/jest":"^29.4.0","@types/node":"^24.0.0","ajv":"^8.17.1","babel-loader":"^10.0.0","body-parser":"^1.20.3","compression":"^1.7.4","eslint":"^9.24.0","eslint-config-prettier":"^10.1.2","express":"^5.0.0","fs-extra":"^11.1.0","gen-esm-wrapper":"^1.1.2","globals":"^16.0.0","jest":"^29.4.3","prettier":"^3.5.3","process":"^0.11.10","puppeteer":"^24.0.0","rimraf":"^6.0.0","source-map-support":"^0.5.21","ts-jest":"^29.0.5","ts-loader":"^9.4.2","ts-node":"^10.9.1","typescript":"^5.8.3","typescript-eslint":"^8.29.1"},"packageManager":"npm@10.9.2"}')
 
 }),
 
@@ -70649,7 +72438,7 @@ __webpack_require__.hu = (chunkId) => ('' + chunkId + '.' + __webpack_require__.
 })();
 // webpack/runtime/get_full_hash
 (() => {
-__webpack_require__.h = () => ("de3c748514a18bb9")
+__webpack_require__.h = () => ("bbfadc107d9db9cb")
 })();
 // webpack/runtime/get_main_filename/update manifest
 (() => {