apify-client 3.0.0-beta.2 → 3.0.0-beta.20

package/dist/resource_clients/user.js

@@ -1,5 +1,7 @@
 import { ResourceClient } from '../base/resource_client.js';
-import { cast, catchNotFoundOrThrow, parseDateFields, pluckData } from '../utils.js';
+import * as schemas from '../schemas.js';
+import { timeoutOptionsSchema } from '../timeouts.js';
+import { parseArgument, parseResponse } from '../utils.js';
 export { PlatformFeature } from '../models.js';
 /**
  * Client for managing user account information.
@@ -41,71 +43,70 @@ export class UserClient extends ResourceClient {
      * Depending on whether ApifyClient was created with a token,
      * the method will either return public or private user data.
      *
-     * @returns The user object.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
+     * @returns The user object, or `undefined` if it does not exist.
      * @see https://docs.apify.com/api/v2/user-get
      */
-    async get() {
-        return this._get();
+    async get(options = {}) {
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        return this.getResource(schemas.UserPrivateInfo(), {}, timeoutSecs);
     }
     /**
      * Retrieves the user's monthly usage data.
      *
-     * @returns The monthly usage object, or `undefined` if it does not exist.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
+     * @returns The monthly usage object.
      * @see https://docs.apify.com/api/v2/users-me-usage-monthly-get
      * @since Added in 2.9.2
      */
-    async monthlyUsage() {
-        const requestOpts = {
-            url: this._url('usage/monthly'),
+    async monthlyUsage(options = {}) {
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        const response = await this.httpClient.call({
+            url: this.buildUrl('usage/monthly'),
             method: 'GET',
-            params: this._params(),
-        };
-        try {
-            const response = await this.httpClient.call(requestOpts);
-            return cast(parseDateFields(pluckData(response.data), 
-            // Convert  monthlyUsage.dailyServiceUsages[].date to Date (by default it's ignored by parseDateFields)
-            /* shouldParseField = */ (key) => key === 'date'));
-        }
-        catch (err) {
-            catchNotFoundOrThrow(err);
-        }
-        return undefined;
+            params: this.buildParams(),
+            timeoutSecs,
+        });
+        return parseResponse(response, schemas.MonthlyUsage());
     }
     /**
      * Retrieves the user's account and usage limits.
      *
-     * @returns The account and usage limits object, or `undefined` if it does not exist.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
+     * @returns The account and usage limits object.
      * @see https://docs.apify.com/api/v2/users-me-limits-get
      * @since Added in 2.9.2
      */
-    async limits() {
-        const requestOpts = {
-            url: this._url('limits'),
+    async limits(options = {}) {
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        const response = await this.httpClient.call({
+            url: this.buildUrl('limits'),
             method: 'GET',
-            params: this._params(),
-        };
-        try {
-            const response = await this.httpClient.call(requestOpts);
-            return cast(parseDateFields(pluckData(response.data)));
-        }
-        catch (err) {
-            catchNotFoundOrThrow(err);
-        }
-        return undefined;
+            params: this.buildParams(),
+            timeoutSecs,
+        });
+        return parseResponse(response, schemas.AccountLimits());
     }
     /**
      * Updates the user's account and usage limits.
      *
-     * @param options - The new limits to set.
+     * @param newLimits - The new limits to set.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @see https://docs.apify.com/api/v2/users-me-limits-put
      * @since Added in 2.10.0
      */
-    async updateLimits(options) {
+    async updateLimits(newLimits, options = {}) {
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
         const requestOpts = {
-            url: this._url('limits'),
+            url: this.buildUrl('limits'),
             method: 'PUT',
-            params: this._params(),
-            data: options,
+            params: this.buildParams(),
+            data: newLimits,
+            timeoutSecs,
         };
         await this.httpClient.call(requestOpts);
     }

package/dist/resource_clients/webhook.d.ts

@@ -1,6 +1,7 @@
 import type { ApiClientSubResourceOptions } from '../base/api_client.js';
 import { ResourceClient } from '../base/resource_client.js';
 import type { Webhook, WebhookEventType } from '../models.js';
+import type { TimeoutOptions } from '../timeouts.js';
 import type { WebhookDispatch } from './webhook_dispatch.js';
 import { WebhookDispatchCollectionClient } from './webhook_dispatch_collection.js';
 export type { Webhook, WebhookAnyRunOfActorCondition, WebhookAnyRunOfActorTaskCondition, WebhookCertainRunCondition, WebhookCondition, WebhookEventType, WebhookLastDispatch, WebhookStats, } from '../models.js';
@@ -40,31 +41,39 @@ export declare class WebhookClient extends ResourceClient {
     /**
      * Retrieves the webhook.
      *
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @returns The webhook object, or `undefined` if it does not exist.
      * @see https://docs.apify.com/api/v2/webhook-get
      */
-    get(): Promise<Webhook | undefined>;
+    get(options?: TimeoutOptions): Promise<Webhook | undefined>;
     /**
      * Updates the webhook with the specified fields.
      *
      * @param newFields - Fields to update.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @returns The updated webhook object.
      * @see https://docs.apify.com/api/v2/webhook-put
      */
-    update(newFields: WebhookUpdateData): Promise<Webhook>;
+    update(newFields: WebhookUpdateData, options?: TimeoutOptions): Promise<Webhook>;
     /**
      * Deletes the webhook.
      *
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @see https://docs.apify.com/api/v2/webhook-delete
      */
-    delete(): Promise<void>;
+    delete(options?: TimeoutOptions): Promise<void>;
     /**
      * Tests the webhook by dispatching a test event.
      *
-     * @returns The webhook dispatch object, or `undefined` if the test fails.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'medium'`.
+     * @returns The webhook dispatch object.
      * @see https://docs.apify.com/api/v2/webhook-test-post
      */
-    test(): Promise<WebhookDispatch | undefined>;
+    test(options?: TimeoutOptions): Promise<WebhookDispatch>;
     /**
      * Returns a client for the dispatches of this webhook.
      *

package/dist/resource_clients/webhook.js

@@ -1,5 +1,7 @@
 import { ResourceClient } from '../base/resource_client.js';
-import { anyObjectSchema, cast, catchNotFoundOrThrow, parseArgument, parseDateFields, pluckData } from '../utils.js';
+import * as schemas from '../schemas.js';
+import { timeoutOptionsSchema } from '../timeouts.js';
+import { anyObjectSchema, parseArgument, parseResponse } from '../utils.js';
 import { WebhookDispatchCollectionClient } from './webhook_dispatch_collection.js';
 /**
  * Client for managing a specific webhook.
@@ -42,51 +44,57 @@ export class WebhookClient extends ResourceClient {
     /**
      * Retrieves the webhook.
      *
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @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();
+    async get(options = {}) {
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        return this.getResource(schemas.Webhook(), {}, timeoutSecs);
     }
     /**
      * Updates the webhook with the specified fields.
      *
      * @param newFields - Fields to update.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @returns The updated webhook object.
      * @see https://docs.apify.com/api/v2/webhook-put
      */
-    async update(newFields) {
+    async update(newFields, options = {}) {
         parseArgument(newFields, anyObjectSchema);
-        return this._update(newFields);
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        return this.updateResource(schemas.Webhook(), newFields, timeoutSecs);
     }
     /**
      * Deletes the webhook.
      *
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @see https://docs.apify.com/api/v2/webhook-delete
      */
-    async delete() {
-        return this._delete();
+    async delete(options = {}) {
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        return this.deleteResource(timeoutSecs);
     }
     /**
      * Tests the webhook by dispatching a test event.
      *
-     * @returns The webhook dispatch object, or `undefined` if the test fails.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'medium'`.
+     * @returns The webhook dispatch object.
      * @see https://docs.apify.com/api/v2/webhook-test-post
      */
-    async test() {
-        const request = {
-            url: this._url('test'),
+    async test(options = {}) {
+        const { timeoutSecs = 'medium' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        const response = await this.httpClient.call({
+            url: this.buildUrl('test'),
             method: 'POST',
-            params: this._params(),
-        };
-        try {
-            const response = await this.httpClient.call(request);
-            return cast(parseDateFields(pluckData(response.data)));
-        }
-        catch (err) {
-            catchNotFoundOrThrow(err);
-        }
-        return undefined;
+            params: this.buildParams(),
+            timeoutSecs,
+        });
+        return parseResponse(response, schemas.WebhookDispatch());
     }
     /**
      * Returns a client for the dispatches of this webhook.
@@ -95,7 +103,7 @@ export class WebhookClient extends ResourceClient {
      * @see https://docs.apify.com/api/v2/webhook-webhook-dispatches-get
      */
     dispatches() {
-        return new WebhookDispatchCollectionClient(this._subResourceOptions({
+        return new WebhookDispatchCollectionClient(this.subResourceOptions({
             resourcePath: 'dispatches',
         }));
     }

package/dist/resource_clients/webhook_collection.d.ts

@@ -1,5 +1,6 @@
 import type { ApiClientSubResourceOptions } from '../base/api_client.js';
 import { ResourceCollectionClient } from '../base/resource_collection_client.js';
+import type { TimeoutOptions } from '../timeouts.js';
 import type { PaginatedIterator, PaginationOptions } from '../utils.js';
 import type { Webhook, WebhookUpdateData } from './webhook.js';
 /**
@@ -47,6 +48,7 @@ export declare class WebhookCollectionClient extends ResourceCollectionClient {
      * ```
      *
      * @param options - Pagination and sorting options.
+     * @param options.timeoutSecs - Timeout for each API request. Default is `'medium'`.
      * @returns A paginated iterator of webhooks.
      * @see https://docs.apify.com/api/v2/webhooks-get
      */
@@ -55,11 +57,13 @@ export declare class WebhookCollectionClient extends ResourceCollectionClient {
      * Creates a new webhook.
      *
      * @param webhook - The webhook data.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @returns The created webhook object.
      * @see https://docs.apify.com/api/v2/webhooks-post
      */
-    create(webhook?: WebhookUpdateData): Promise<Webhook>;
+    create(webhook?: WebhookUpdateData, options?: TimeoutOptions): Promise<Webhook>;
 }
-export interface WebhookCollectionListOptions extends PaginationOptions {
+export interface WebhookCollectionListOptions extends PaginationOptions, TimeoutOptions {
     desc?: boolean;
 }

package/dist/resource_clients/webhook_collection.js

@@ -1,9 +1,12 @@
 import { z } from 'zod';
 import { ResourceCollectionClient } from '../base/resource_collection_client.js';
+import * as schemas from '../schemas.js';
+import { timeoutOptionsSchema, timeoutOptionsShape } from '../timeouts.js';
 import { anyObjectSchema, paginationOptionsShape, parseArgument } from '../utils.js';
 const listOptionsSchema = z.strictObject({
     ...paginationOptionsShape,
     desc: z.boolean().optional(),
+    ...timeoutOptionsShape,
 });
 const webhookCreateSchema = anyObjectSchema.optional();
 /**
@@ -56,22 +59,26 @@ export class WebhookCollectionClient extends ResourceCollectionClient {
      * ```
      *
      * @param options - Pagination and sorting options.
+     * @param options.timeoutSecs - Timeout for each API request. Default is `'medium'`.
      * @returns A paginated iterator of webhooks.
      * @see https://docs.apify.com/api/v2/webhooks-get
      */
     list(options = {}) {
         const parsed = parseArgument(options, listOptionsSchema, 'WebhookCollectionListOptions');
-        return this._listPaginated(parsed);
+        return this.listResourcesPaginated(schemas.ListOfWebhooks(), parsed, 'medium');
     }
     /**
      * Creates a new webhook.
      *
      * @param webhook - The webhook data.
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @returns The created webhook object.
      * @see https://docs.apify.com/api/v2/webhooks-post
      */
-    async create(webhook) {
+    async create(webhook, options = {}) {
         parseArgument(webhook, webhookCreateSchema);
-        return this._create(webhook);
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        return this.createResource(schemas.Webhook(), webhook, timeoutSecs);
     }
 }

package/dist/resource_clients/webhook_dispatch.d.ts

@@ -1,6 +1,7 @@
 import type { ApiClientSubResourceOptions } from '../base/api_client.js';
 import { ResourceClient } from '../base/resource_client.js';
 import type { WebhookDispatch } from '../models.js';
+import type { TimeoutOptions } from '../timeouts.js';
 export type { WebhookDispatch, WebhookDispatchCall, WebhookDispatchEventData, WebhookDispatchWebhookSummary, } from '../models.js';
 export { WebhookDispatchStatus } from '../models.js';
 /**
@@ -29,8 +30,10 @@ export declare class WebhookDispatchClient extends ResourceClient {
     /**
      * Retrieves the webhook dispatch.
      *
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @returns The webhook dispatch object, or `undefined` if it does not exist.
      * @see https://docs.apify.com/api/v2/webhook-dispatch-get
      */
-    get(): Promise<WebhookDispatch | undefined>;
+    get(options?: TimeoutOptions): Promise<WebhookDispatch | undefined>;
 }

package/dist/resource_clients/webhook_dispatch.js

@@ -1,4 +1,7 @@
 import { ResourceClient } from '../base/resource_client.js';
+import * as schemas from '../schemas.js';
+import { timeoutOptionsSchema } from '../timeouts.js';
+import { parseArgument } from '../utils.js';
 export { WebhookDispatchStatus } from '../models.js';
 /**
  * Client for managing a specific webhook dispatch.
@@ -31,10 +34,13 @@ export class WebhookDispatchClient extends ResourceClient {
     /**
      * Retrieves the webhook dispatch.
      *
+     * @param options - Request options
+     * @param options.timeoutSecs - Timeout for the API request. Default is `'short'`.
      * @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();
+    async get(options = {}) {
+        const { timeoutSecs = 'short' } = parseArgument(options, timeoutOptionsSchema, 'TimeoutOptions');
+        return this.getResource(schemas.WebhookDispatch(), {}, timeoutSecs);
     }
 }

package/dist/resource_clients/webhook_dispatch_collection.d.ts

@@ -1,5 +1,6 @@
 import type { ApiClientSubResourceOptions } from '../base/api_client.js';
 import { ResourceCollectionClient } from '../base/resource_collection_client.js';
+import type { TimeoutOptions } from '../timeouts.js';
 import type { PaginatedIterator, PaginationOptions } from '../utils.js';
 import type { WebhookDispatch } from './webhook_dispatch.js';
 /**
@@ -42,11 +43,12 @@ export declare class WebhookDispatchCollectionClient extends ResourceCollectionC
      * ```
      *
      * @param options - Pagination and sorting options.
+     * @param options.timeoutSecs - Timeout for each API request. Default is `'medium'`.
      * @returns A paginated iterator of webhook dispatches.
      * @see https://docs.apify.com/api/v2/webhook-dispatches-get
      */
     list(options?: WebhookDispatchCollectionListOptions): PaginatedIterator<WebhookDispatch>;
 }
-export interface WebhookDispatchCollectionListOptions extends PaginationOptions {
+export interface WebhookDispatchCollectionListOptions extends PaginationOptions, TimeoutOptions {
     desc?: boolean;
 }

package/dist/resource_clients/webhook_dispatch_collection.js

@@ -1,9 +1,12 @@
 import { z } from 'zod';
 import { ResourceCollectionClient } from '../base/resource_collection_client.js';
+import * as schemas from '../schemas.js';
+import { timeoutOptionsShape } from '../timeouts.js';
 import { paginationOptionsShape, parseArgument } from '../utils.js';
 const listOptionsSchema = z.strictObject({
     ...paginationOptionsShape,
     desc: z.boolean().optional(),
+    ...timeoutOptionsShape,
 });
 /**
  * Client for managing the collection of webhook dispatches.
@@ -50,11 +53,12 @@ export class WebhookDispatchCollectionClient extends ResourceCollectionClient {
      * ```
      *
      * @param options - Pagination and sorting options.
+     * @param options.timeoutSecs - Timeout for each API request. Default is `'medium'`.
      * @returns A paginated iterator of webhook dispatches.
      * @see https://docs.apify.com/api/v2/webhook-dispatches-get
      */
     list(options = {}) {
         const parsed = parseArgument(options, listOptionsSchema, 'WebhookDispatchCollectionListOptions');
-        return this._listPaginated(parsed);
+        return this.listResourcesPaginated(schemas.ListOfWebhookDispatches(), parsed, 'medium');
     }
 }

package/dist/response_validation_error.d.ts

@@ -0,0 +1,26 @@
+import type { z } from 'zod';
+/**
+ * Thrown when an API response does not match the schema the client expects for it.
+ *
+ * The schemas are generated from the Apify OpenAPI specification, so this error means the API returned
+ * something the specification does not describe -- a missing required field, a different type, a value
+ * outside the documented range. Unknown fields and unknown enum values are not errors: the schemas let
+ * both through, so the client keeps working when the API grows.
+ *
+ * The `message` names the request and every offending field with the value it received, and ends by asking for
+ * a bug report: the mismatch is in the API or its specification, not in the caller's code. The structured
+ * {@link https://zod.dev | zod} issues are available on `issues`, and the original `ZodError` on `cause`,
+ * for programmatic inspection.
+ */
+export declare class ResponseValidationError extends Error {
+    /** Structured issues from the underlying schema check. */
+    readonly issues: z.ZodError['issues'];
+    /** HTTP method of the request whose response failed validation, upper-cased. */
+    readonly method: string;
+    /** URL of the request whose response failed validation, without its query string. */
+    readonly url: string;
+    constructor(error: z.ZodError, value: unknown, request: {
+        method: string;
+        url: string;
+    });
+}

package/dist/response_validation_error.js

@@ -0,0 +1,37 @@
+import { ArgumentValidationError } from '@apify/validations';
+const REPORT_HINT = 'The API returned something its OpenAPI specification does not describe. ' +
+    'Please report this at https://github.com/apify/apify-client-js/issues.';
+/**
+ * Thrown when an API response does not match the schema the client expects for it.
+ *
+ * The schemas are generated from the Apify OpenAPI specification, so this error means the API returned
+ * something the specification does not describe -- a missing required field, a different type, a value
+ * outside the documented range. Unknown fields and unknown enum values are not errors: the schemas let
+ * both through, so the client keeps working when the API grows.
+ *
+ * The `message` names the request and every offending field with the value it received, and ends by asking for
+ * a bug report: the mismatch is in the API or its specification, not in the caller's code. The structured
+ * {@link https://zod.dev | zod} issues are available on `issues`, and the original `ZodError` on `cause`,
+ * for programmatic inspection.
+ */
+export class ResponseValidationError extends Error {
+    /** Structured issues from the underlying schema check. */
+    issues;
+    /** HTTP method of the request whose response failed validation, upper-cased. */
+    method;
+    /** URL of the request whose response failed validation, without its query string. */
+    url;
+    constructor(error, value, request) {
+        const method = request.method.toUpperCase();
+        // `@apify/validations` keeps its zod error formatter private, so the issue lines come from the
+        // message of the error class it does export.
+        const details = new ArgumentValidationError(error, value).message;
+        super(`Response from ${method} ${request.url} does not match the API schema:\n${details}\n${REPORT_HINT}`, {
+            cause: error,
+        });
+        this.name = 'ResponseValidationError';
+        this.issues = error.issues;
+        this.method = method;
+        this.url = request.url;
+    }
+}

package/dist/schemas.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The schemas the resource clients validate API responses with.
+ *
+ * Today these are exactly the generated ones. The module still exists as the one place where a generated
+ * schema is widened when the API is known to return something the specification does not describe, so a
+ * documented deviation never sends a resource client reaching into `./generated` directly. An override
+ * declared here shadows the generated export of the same name and takes the same form, a `lazySchema()` thunk
+ * built on the generated schema it replaces. Every schema that embeds an overridden one has to be rebuilt on
+ * top of it, and `spec_guards.ts` checks that each override still produces what the specification describes,
+ * so one cannot narrow by accident.
+ *
+ * Spec gaps need no override: the generated objects are loose, so a field the specification omits passes
+ * through. Neither do client narrowings: a schema only ever accepts more than the published type.
+ */
+export * from './generated/schemas.js';

package/dist/schemas.js

@@ -0,0 +1,15 @@
+/**
+ * The schemas the resource clients validate API responses with.
+ *
+ * Today these are exactly the generated ones. The module still exists as the one place where a generated
+ * schema is widened when the API is known to return something the specification does not describe, so a
+ * documented deviation never sends a resource client reaching into `./generated` directly. An override
+ * declared here shadows the generated export of the same name and takes the same form, a `lazySchema()` thunk
+ * built on the generated schema it replaces. Every schema that embeds an overridden one has to be rebuilt on
+ * top of it, and `spec_guards.ts` checks that each override still produces what the specification describes,
+ * so one cannot narrow by accident.
+ *
+ * Spec gaps need no override: the generated objects are loose, so a field the specification omits passes
+ * through. Neither do client narrowings: a schema only ever accepts more than the published type.
+ */
+export * from './generated/schemas.js';

package/dist/statistics.d.ts

@@ -1,4 +1,5 @@
 export declare class Statistics {
+    #private;
     /**
      * Number of Apify client function calls
      */
@@ -13,10 +14,4 @@ export declare class Statistics {
      */
     rateLimitErrors: number[];
     addRateLimitError(attempt: number): void;
-    /**
-     * Removes the necessity to pre-initialize array with correct
-     * number of zeroes by dynamically filling the empty indexes
-     * when necessary.
-     */
-    private _fillBlanksWithZeroes;
 }

package/dist/statistics.js

@@ -20,7 +20,7 @@ export class Statistics {
         // attempt is never 0,
         // but we don't want index 0 empty
         const index = attempt - 1;
-        this._fillBlanksWithZeroes(index);
+        this.#fillBlanksWithZeroes(index);
         this.rateLimitErrors[index]++;
     }
     /**
@@ -28,7 +28,7 @@ export class Statistics {
      * number of zeroes by dynamically filling the empty indexes
      * when necessary.
      */
-    _fillBlanksWithZeroes(inclusiveIndex) {
+    #fillBlanksWithZeroes(inclusiveIndex) {
         if (this.rateLimitErrors.length <= inclusiveIndex) {
             for (let k = 0; k <= inclusiveIndex; k++) {
                 if (typeof this.rateLimitErrors[k] !== 'number') {

package/dist/timeouts.d.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+/** Default duration of the `short` timeout tier, in seconds. */
+export declare const DEFAULT_TIMEOUT_SHORT_SECS = 5;
+/** Default duration of the `medium` timeout tier, in seconds. */
+export declare const DEFAULT_TIMEOUT_MEDIUM_SECS = 30;
+/** Default duration of the `long` timeout tier, in seconds. */
+export declare const DEFAULT_TIMEOUT_LONG_SECS = 360;
+/** Default cap on the timeout of a single request attempt, in seconds. */
+export declare const DEFAULT_TIMEOUT_MAX_SECS = 360;
+/**
+ * Preconfigured timeout tiers. Every client method picks the tier that fits the expected duration of its
+ * request: `short` for simple metadata reads and writes, `medium` for listing, batch and trigger operations,
+ * `long` for downloads, uploads and streaming. The duration of each tier is set on the {@link ApifyClient}
+ * constructor.
+ */
+export type TimeoutTier = 'short' | 'medium' | 'long';
+/**
+ * Timeout of a single API request.
+ *
+ * A tier name picks the duration configured for that tier on the {@link ApifyClient} constructor, a number is
+ * an exact duration in seconds, and `'noTimeout'` lets the request run for as long as it takes. A tier or an
+ * explicit duration above `timeoutMaxSecs` is capped at it, and the client logs a warning when that happens.
+ * The timeout applies to each attempt separately, and doubles with every retry up to the same cap.
+ *
+ * With `'noTimeout'` the client never aborts the request, so a connection that stalls is not retried either.
+ */
+export type Timeout = TimeoutTier | 'noTimeout' | number;
+/**
+ * Options shared by every method that sends a request to the API.
+ */
+export interface TimeoutOptions {
+    /**
+     * Timeout for the API request: a tier name (`'short'`, `'medium'`, `'long'`), a number of seconds, or
+     * `'noTimeout'`. Defaults to the tier the method is assigned, which its documentation names.
+     */
+    timeoutSecs?: Timeout;
+}
+/**
+ * Schema of {@link Timeout}, optional, for the methods that validate `timeoutSecs` on its own.
+ * @internal
+ */
+export declare const optionalTimeoutSchema: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+    short: "short";
+    medium: "medium";
+    long: "long";
+    noTimeout: "noTimeout";
+}>, z.ZodNumber]>>;
+/**
+ * Schema shape of {@link TimeoutOptions}, to spread into the option schema of every method that sends a
+ * request. One copy stops it drifting from the interface.
+ * @internal
+ */
+export declare const timeoutOptionsShape: {
+    timeoutSecs: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        short: "short";
+        medium: "medium";
+        long: "long";
+        noTimeout: "noTimeout";
+    }>, z.ZodNumber]>>;
+};
+/**
+ * Schema of {@link TimeoutOptions}, for the methods that take no other option.
+ * @internal
+ */
+export declare const timeoutOptionsSchema: z.ZodObject<{
+    timeoutSecs: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        short: "short";
+        medium: "medium";
+        long: "long";
+        noTimeout: "noTimeout";
+    }>, z.ZodNumber]>>;
+}, z.core.$strict>;