apify-client 2.25.1-beta.7 → 3.0.0-beta.0

package/dist/resource_clients/store_collection.js

@@ -1,9 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StoreCollectionClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const resource_collection_client_1 = require("../base/resource_collection_client");
+const utils_1 = require("../utils");
+const listOptionsSchema = zod_1.z.strictObject({
+    ...utils_1.paginationOptionsShape,
+    search: zod_1.z.string().optional(),
+    sortBy: zod_1.z.string().optional(),
+    category: zod_1.z.string().optional(),
+    username: zod_1.z.string().optional(),
+    pricingModel: zod_1.z.string().optional(),
+    includeUnrunnableActors: zod_1.z.boolean().optional(),
+});
 /**
  * Client for browsing Actors in the Apify Store.
  *
@@ -56,17 +65,8 @@ class StoreCollectionClient extends resource_collection_client_1.ResourceCollect
      * @see https://docs.apify.com/api/v2/store-get
      */
     list(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            search: ow_1.default.optional.string,
-            sortBy: ow_1.default.optional.string,
-            category: ow_1.default.optional.string,
-            username: ow_1.default.optional.string,
-            pricingModel: ow_1.default.optional.string,
-            includeUnrunnableActors: ow_1.default.optional.boolean,
-        }));
-        return this._listPaginated(options);
+        const parsed = (0, utils_1.parseArgument)(options, listOptionsSchema, 'StoreCollectionListOptions');
+        return this._listPaginated(parsed);
     }
 }
 exports.StoreCollectionClient = StoreCollectionClient;

package/dist/resource_clients/task.js

@@ -1,14 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const consts_1 = require("@apify/consts");
 const resource_client_1 = require("../base/resource_client");
 const utils_1 = require("../utils");
 const run_1 = require("./run");
 const run_collection_1 = require("./run_collection");
 const webhook_collection_1 = require("./webhook_collection");
+const inputSchema = utils_1.anyObjectSchema.optional();
+const startOptionsSchema = zod_1.z.strictObject({
+    build: zod_1.z.string().optional(),
+    memory: zod_1.z.number().optional(),
+    timeout: zod_1.z.number().optional(),
+    waitForFinish: zod_1.z.number().optional(),
+    webhooks: zod_1.z.array(utils_1.anyObjectSchema).optional(),
+    maxItems: zod_1.z.number().min(0).optional(),
+    maxTotalChargeUsd: zod_1.z.number().min(0).optional(),
+    restartOnError: zod_1.z.boolean().optional(),
+});
+const callOptionsSchema = zod_1.z.strictObject({
+    build: zod_1.z.string().optional(),
+    memory: zod_1.z.number().optional(),
+    timeout: zod_1.z.number().min(0).optional(),
+    waitSecs: zod_1.z.number().min(0).optional(),
+    webhooks: zod_1.z.array(utils_1.anyObjectSchema).optional(),
+    maxItems: zod_1.z.number().min(0).optional(),
+    maxTotalChargeUsd: zod_1.z.number().min(0).optional(),
+    restartOnError: zod_1.z.boolean().optional(),
+});
+const lastRunOptionsSchema = zod_1.z.strictObject({
+    status: zod_1.z.enum(consts_1.ACT_JOB_STATUSES).optional(),
+    origin: zod_1.z.enum(consts_1.META_ORIGINS).optional(),
+});
 /**
  * Client for managing a specific Actor task.
  *
@@ -56,7 +80,7 @@ class TaskClient extends resource_client_1.ResourceClient {
      * @see https://docs.apify.com/api/v2/actor-task-put
      */
     async update(newFields) {
-        (0, ow_1.default)(newFields, ow_1.default.object);
+        (0, utils_1.parseArgument)(newFields, utils_1.anyObjectSchema);
         return this._update(newFields);
     }
     /**
@@ -114,24 +138,15 @@ class TaskClient extends resource_client_1.ResourceClient {
      * @see https://docs.apify.com/api/v2/actor-task-runs-post
      */
     async start(input, options = {}) {
-        (0, ow_1.default)(input, ow_1.default.optional.object);
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            build: ow_1.default.optional.string,
-            memory: ow_1.default.optional.number,
-            timeout: ow_1.default.optional.number,
-            waitForFinish: ow_1.default.optional.number,
-            webhooks: ow_1.default.optional.array.ofType(ow_1.default.object),
-            maxItems: ow_1.default.optional.number.not.negative,
-            maxTotalChargeUsd: ow_1.default.optional.number.not.negative,
-            restartOnError: ow_1.default.optional.boolean,
-        }));
-        const { waitForFinish, timeout, memory, build, maxItems, maxTotalChargeUsd, restartOnError } = options;
+        (0, utils_1.parseArgument)(input, inputSchema);
+        const parsed = (0, utils_1.parseArgument)(options, startOptionsSchema, 'TaskStartOptions');
+        const { waitForFinish, timeout, memory, build, maxItems, maxTotalChargeUsd, restartOnError } = parsed;
         const params = {
             waitForFinish,
             timeout,
             memory,
             build,
-            webhooks: (0, utils_1.stringifyWebhooksToBase64)(options.webhooks),
+            webhooks: (0, utils_1.stringifyWebhooksToBase64)(parsed.webhooks),
             maxItems,
             maxTotalChargeUsd,
             restartOnError,
@@ -169,18 +184,9 @@ class TaskClient extends resource_client_1.ResourceClient {
      * @see https://docs.apify.com/api/v2/actor-task-runs-post
      */
     async call(input, options = {}) {
-        (0, ow_1.default)(input, ow_1.default.optional.object);
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            build: ow_1.default.optional.string,
-            memory: ow_1.default.optional.number,
-            timeout: ow_1.default.optional.number.not.negative,
-            waitSecs: ow_1.default.optional.number.not.negative,
-            webhooks: ow_1.default.optional.array.ofType(ow_1.default.object),
-            maxItems: ow_1.default.optional.number.not.negative,
-            maxTotalChargeUsd: ow_1.default.optional.number.not.negative,
-            restartOnError: ow_1.default.optional.boolean,
-        }));
-        const { waitSecs, ...startOptions } = options;
+        (0, utils_1.parseArgument)(input, inputSchema);
+        const parsed = (0, utils_1.parseArgument)(options, callOptionsSchema, 'TaskCallOptions');
+        const { waitSecs, ...startOptions } = parsed;
         const { id } = await this.start(input, startOptions);
         // Calling root client because we need access to top level API.
         // Creating a new instance of RunClient here would only allow
@@ -234,13 +240,10 @@ class TaskClient extends resource_client_1.ResourceClient {
      * @see https://docs.apify.com/api/v2/actor-task-runs-last-get
      */
     lastRun(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            status: ow_1.default.optional.string.oneOf(Object.values(consts_1.ACT_JOB_STATUSES)),
-            origin: ow_1.default.optional.string.oneOf(Object.values(consts_1.META_ORIGINS)),
-        }));
+        const parsed = (0, utils_1.parseArgument)(options, lastRunOptionsSchema, 'TaskLastRunOptions');
         return new run_1.RunClient(this._subResourceOptions({
             id: 'last',
-            params: this._params(options),
+            params: this._params(parsed),
             resourcePath: 'runs',
         }));
     }

package/dist/resource_clients/task_collection.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TaskCollectionClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const resource_collection_client_1 = require("../base/resource_collection_client");
+const utils_1 = require("../utils");
+const listOptionsSchema = zod_1.z.strictObject({
+    ...utils_1.paginationOptionsShape,
+    desc: zod_1.z.boolean().optional(),
+});
 /**
  * Client for managing the collection of Actor tasks in your account.
  *
@@ -59,12 +63,8 @@ class TaskCollectionClient extends resource_collection_client_1.ResourceCollecti
      * @see https://docs.apify.com/api/v2/actor-tasks-get
      */
     list(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            desc: ow_1.default.optional.boolean,
-        }));
-        return this._listPaginated(options);
+        const parsed = (0, utils_1.parseArgument)(options, listOptionsSchema, 'TaskCollectionListOptions');
+        return this._listPaginated(parsed);
     }
     /**
      * Creates a new task.
@@ -74,7 +74,7 @@ class TaskCollectionClient extends resource_collection_client_1.ResourceCollecti
      * @see https://docs.apify.com/api/v2/actor-tasks-post
      */
     async create(task) {
-        (0, ow_1.default)(task, ow_1.default.object);
+        (0, utils_1.parseArgument)(task, utils_1.anyObjectSchema);
         return this._create(task);
     }
 }

package/dist/resource_clients/webhook.js

@@ -1,8 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhookClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
 const resource_client_1 = require("../base/resource_client");
 const utils_1 = require("../utils");
 const webhook_dispatch_collection_1 = require("./webhook_dispatch_collection");
@@ -61,7 +59,7 @@ class WebhookClient extends resource_client_1.ResourceClient {
      * @see https://docs.apify.com/api/v2/webhook-put
      */
     async update(newFields) {
-        (0, ow_1.default)(newFields, ow_1.default.object);
+        (0, utils_1.parseArgument)(newFields, utils_1.anyObjectSchema);
         return this._update(newFields);
     }
     /**

package/dist/resource_clients/webhook_collection.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhookCollectionClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const resource_collection_client_1 = require("../base/resource_collection_client");
+const utils_1 = require("../utils");
+const listOptionsSchema = zod_1.z.strictObject({
+    ...utils_1.paginationOptionsShape,
+    desc: zod_1.z.boolean().optional(),
+});
+const webhookCreateSchema = utils_1.anyObjectSchema.optional();
 /**
  * Client for managing the collection of Webhooks.
  *
@@ -58,12 +63,8 @@ class WebhookCollectionClient extends resource_collection_client_1.ResourceColle
      * @see https://docs.apify.com/api/v2/webhooks-get
      */
     list(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            desc: ow_1.default.optional.boolean,
-        }));
-        return this._listPaginated(options);
+        const parsed = (0, utils_1.parseArgument)(options, listOptionsSchema, 'WebhookCollectionListOptions');
+        return this._listPaginated(parsed);
     }
     /**
      * Creates a new webhook.
@@ -73,7 +74,7 @@ class WebhookCollectionClient extends resource_collection_client_1.ResourceColle
      * @see https://docs.apify.com/api/v2/webhooks-post
      */
     async create(webhook) {
-        (0, ow_1.default)(webhook, ow_1.default.optional.object);
+        (0, utils_1.parseArgument)(webhook, webhookCreateSchema);
         return this._create(webhook);
     }
 }

package/dist/resource_clients/webhook_dispatch_collection.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhookDispatchCollectionClient = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
 const resource_collection_client_1 = require("../base/resource_collection_client");
+const utils_1 = require("../utils");
+const listOptionsSchema = zod_1.z.strictObject({
+    ...utils_1.paginationOptionsShape,
+    desc: zod_1.z.boolean().optional(),
+});
 /**
  * Client for managing the collection of webhook dispatches.
  *
@@ -53,12 +57,8 @@ class WebhookDispatchCollectionClient extends resource_collection_client_1.Resou
      * @see https://docs.apify.com/api/v2/webhook-dispatches-get
      */
     list(options = {}) {
-        (0, ow_1.default)(options, ow_1.default.object.exactShape({
-            limit: ow_1.default.optional.number.not.negative,
-            offset: ow_1.default.optional.number.not.negative,
-            desc: ow_1.default.optional.boolean,
-        }));
-        return this._listPaginated(options);
+        const parsed = (0, utils_1.parseArgument)(options, listOptionsSchema, 'WebhookDispatchCollectionListOptions');
+        return this._listPaginated(parsed);
     }
 }
 exports.WebhookDispatchCollectionClient = WebhookDispatchCollectionClient;

package/dist/statistics.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Statistics = void 0;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+const zod_1 = require("zod");
+const utils_1 = require("./utils");
+const attemptSchema = zod_1.z.number().gt(0);
 class Statistics {
     /**
      * Number of Apify client function calls
@@ -18,7 +19,7 @@ class Statistics {
      */
     rateLimitErrors = [];
     addRateLimitError(attempt) {
-        (0, ow_1.default)(attempt, ow_1.default.number.greaterThan(0));
+        (0, utils_1.parseArgument)(attempt, attemptSchema);
         // attempt is never 0,
         // but we don't want index 0 empty
         const index = attempt - 1;

package/dist/utils.d.ts

@@ -1,8 +1,30 @@
 import type { Readable } from 'node:stream';
 import type { JsonValue, TypedArray } from 'type-fest';
+import { z } from 'zod';
 import type { ApifyApiError } from './apify_api_error';
 import type { RequestQueueClientListRequestsOptions, RequestQueueClientListRequestsResult } from './resource_clients/request_queue';
 import type { WebhookUpdateData } from './resource_clients/webhook';
+/**
+ * Parses `value` with `schema`, returning the typed result (with schema defaults applied).
+ * Throws {@link ArgumentValidationError} on failure.
+ *
+ * The optional `label` names the interface being validated and is appended to every error line
+ * (e.g. ``... at `memory` in `ActorStartOptions` ``).
+ * @internal
+ */
+export declare function parseArgument<TValue, TSchema extends z.ZodType>(value: TValue, schema: TSchema, label?: string): TValue & z.output<TSchema>;
+/**
+ * Accepts any non-null, non-array object as a predicate for `z.custom()`.
+ * @internal
+ */
+export declare function isNonArrayObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Matches any plain object, letting unknown keys through - for payloads whose shape the API
+ * validates itself. A `z.custom()` predicate rather than an object schema, so parsing returns
+ * the value itself instead of a copy.
+ * @internal
+ */
+export declare const anyObjectSchema: z.ZodCustom<Record<string, unknown>, Record<string, unknown>>;
 /**
  * Generic interface for objects that may contain a data property.
  *
@@ -40,7 +62,7 @@ export declare function parseDateFields(input: JsonValue, shouldParseField?: ((k
 /**
  * Helper function that converts array of webhooks to base64 string
  */
-export declare function stringifyWebhooksToBase64(webhooks: WebhookUpdateData[]): string | undefined;
+export declare function stringifyWebhooksToBase64(webhooks?: readonly WebhookUpdateData[]): string | undefined;
 export interface CompressedValue {
     data: Buffer;
     encoding: 'br' | 'gzip';
@@ -103,6 +125,16 @@ export interface PaginationOptions {
      * */
     chunkSize?: number;
 }
+/**
+ * Schema shape of {@link PaginationOptions}, to spread into every paginating client's list schema. One
+ * copy stops it drifting from the interface.
+ * @internal
+ */
+export declare const paginationOptionsShape: {
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    chunkSize: z.ZodOptional<z.ZodNumber>;
+};
 /**
  * Standard paginated response format.
  *
@@ -160,8 +192,22 @@ export type DistributiveOptional<T, K extends keyof T> = T extends any ? Omit<T,
  * Adds query parameters to a given URL based on the provided options object.
  */
 export declare function applyQueryParamsToUrl(url: URL, options?: Record<string, string | number | boolean | string[] | undefined>): URL;
-export declare const mutuallyExclusive: <T, K extends keyof T>(...keys: K[]) => (value: T) => {
-    validator: boolean;
-    message: string;
-};
+/**
+ * Builds a `[check, message]` pair to spread into `.refine()`, asserting that at most one of `keys`
+ * is present. Pass the options interface as `T`, so that a misspelled key is a type error.
+ * @internal
+ */
+export declare const mutuallyExclusive: <T extends object>(...keys: (keyof T & string)[]) => [(value: T) => boolean, string];
+/**
+ * Percent-encodes a caller-supplied URL path segment so it cannot restructure the request path.
+ *
+ * Empty strings and dot segments are rejected instead of encoded, because URL parsers resolve
+ * dot segments after decoding - `records/%2E%2E` collapses to the parent endpoint just like `records/..`.
+ */
+export declare function toPathSegment(value: string): string;
+/**
+ * Builds a URL path from segments. A plain string is used as-is, so literal paths such as
+ * `requests/batch` keep their separators; an array has each of its segments encoded individually.
+ */
+export declare function toPath(path: string | string[]): string;
 export {};

package/dist/utils.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mutuallyExclusive = exports.RequestQueuePaginationIterator = void 0;
+exports.mutuallyExclusive = exports.paginationOptionsShape = exports.RequestQueuePaginationIterator = exports.anyObjectSchema = void 0;
+exports.parseArgument = parseArgument;
+exports.isNonArrayObject = isNonArrayObject;
 exports.pluckData = pluckData;
 exports.catchNotFoundOrThrow = catchNotFoundOrThrow;
 exports.parseDateFields = parseDateFields;
@@ -14,12 +16,49 @@ exports.getVersionData = getVersionData;
 exports.cast = cast;
 exports.asArray = asArray;
 exports.applyQueryParamsToUrl = applyQueryParamsToUrl;
-const tslib_1 = require("tslib");
-const ow_1 = tslib_1.__importDefault(require("ow"));
+exports.toPathSegment = toPathSegment;
+exports.toPath = toPath;
+const zod_1 = require("zod");
+const argument_validation_error_1 = require("./argument_validation_error");
 const NOT_FOUND_STATUS_CODE = 404;
 const RECORD_NOT_FOUND_TYPE = 'record-not-found';
 const RECORD_OR_TOKEN_NOT_FOUND_TYPE = 'record-or-token-not-found';
 const MIN_COMPRESS_BYTES = 1024;
+// Zod installs its English locale as a module-level side effect but ships `"sideEffects": false`, so
+// any tree-shaking bundler drops it and every message degrades to a bare "Invalid input". Passing it
+// in per parse keeps them intact without reaching into the zod config the whole process shares.
+const { localeError } = zod_1.z.locales.en();
+/**
+ * Parses `value` with `schema`, returning the typed result (with schema defaults applied).
+ * Throws {@link ArgumentValidationError} on failure.
+ *
+ * The optional `label` names the interface being validated and is appended to every error line
+ * (e.g. ``... at `memory` in `ActorStartOptions` ``).
+ * @internal
+ */
+function parseArgument(value, schema, label) {
+    const result = schema.safeParse(value, { error: localeError });
+    if (!result.success) {
+        throw new argument_validation_error_1.ArgumentValidationError(result.error, value, label);
+    }
+    return result.data;
+}
+/**
+ * Accepts any non-null, non-array object as a predicate for `z.custom()`.
+ * @internal
+ */
+function isNonArrayObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Matches any plain object, letting unknown keys through - for payloads whose shape the API
+ * validates itself. A `z.custom()` predicate rather than an object schema, so parsing returns
+ * the value itself instead of a copy.
+ * @internal
+ */
+exports.anyObjectSchema = zod_1.z.custom(isNonArrayObject, {
+    error: 'Invalid input: expected an object',
+});
 /**
  * Returns object's 'data' property or throws if parameter is not an object,
  * or an object without a 'data' property.
@@ -183,10 +222,20 @@ function isNode() {
     return !!(typeof process !== 'undefined' && process.versions && process.versions.node);
 }
 function isBuffer(value) {
-    return ow_1.default.isValid(value, ow_1.default.any(ow_1.default.buffer, ow_1.default.arrayBuffer, ow_1.default.typedArray));
+    // Tag checks rather than `instanceof`, to also match buffers from another realm. `isView()`
+    // additionally covers `DataView`, which is not raw binary content.
+    if (ArrayBuffer.isView(value))
+        return !isTagged(value, 'DataView');
+    return isTagged(value, 'ArrayBuffer');
+}
+function isTagged(value, tag) {
+    return Object.prototype.toString.call(value) === `[object ${tag}]`;
 }
 function isStream(value) {
-    return ow_1.default.isValid(value, ow_1.default.object.hasKeys('on', 'pipe'));
+    if (value === null || typeof value !== 'object')
+        return false;
+    const { on, pipe } = value;
+    return typeof on === 'function' && typeof pipe === 'function';
 }
 function getVersionData() {
     if (typeof BROWSER_BUILD !== 'undefined') {
@@ -239,6 +288,16 @@ class RequestQueuePaginationIterator {
     }
 }
 exports.RequestQueuePaginationIterator = RequestQueuePaginationIterator;
+/**
+ * Schema shape of {@link PaginationOptions}, to spread into every paginating client's list schema. One
+ * copy stops it drifting from the interface.
+ * @internal
+ */
+exports.paginationOptionsShape = {
+    limit: zod_1.z.number().min(0).optional(),
+    offset: zod_1.z.number().min(0).optional(),
+    chunkSize: zod_1.z.number().positive().optional(),
+};
 function cast(input) {
     return input;
 }
@@ -265,11 +324,34 @@ function applyQueryParamsToUrl(url, options) {
     }
     return url;
 }
-const mutuallyExclusive = (...keys) => (value) => {
-    const presentKeys = keys.filter((key) => typeof value[key] !== 'undefined');
-    return {
-        validator: presentKeys.length <= 1,
-        message: `At most one of the following fields is allowed: ${keys.join(', ')}`,
-    };
-};
+/**
+ * Builds a `[check, message]` pair to spread into `.refine()`, asserting that at most one of `keys`
+ * is present. Pass the options interface as `T`, so that a misspelled key is a type error.
+ * @internal
+ */
+const mutuallyExclusive = (...keys) => [
+    (value) => keys.filter((key) => typeof value[key] !== 'undefined').length <= 1,
+    `At most one of the following fields is allowed: ${keys.join(', ')}`,
+];
 exports.mutuallyExclusive = mutuallyExclusive;
+const pathSegmentSchema = zod_1.z
+    .string()
+    .nonempty()
+    .refine((v) => v !== '.' && v !== '..', { error: 'URL path must not contain dot segments' });
+/**
+ * Percent-encodes a caller-supplied URL path segment so it cannot restructure the request path.
+ *
+ * Empty strings and dot segments are rejected instead of encoded, because URL parsers resolve
+ * dot segments after decoding - `records/%2E%2E` collapses to the parent endpoint just like `records/..`.
+ */
+function toPathSegment(value) {
+    const valueParsed = parseArgument(value, pathSegmentSchema);
+    return encodeURIComponent(valueParsed);
+}
+/**
+ * Builds a URL path from segments. A plain string is used as-is, so literal paths such as
+ * `requests/batch` keep their separators; an array has each of its segments encoded individually.
+ */
+function toPath(path) {
+    return Array.isArray(path) ? path.map(toPathSegment).join('/') : path;
+}

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "apify-client",
-  "version": "2.25.1-beta.7",
+  "version": "3.0.0-beta.0",
   "description": "Apify API client for JavaScript",
+  "engines": {
+    "node": ">=22.0.0"
+  },
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -57,10 +60,10 @@
     "async-retry": "^1.3.3",
     "axios": "^1.16.0",
     "content-type": "^1.0.5",
-    "ow": "^0.28.2",
     "proxy-agent": "^6.5.0",
     "tslib": "^2.5.0",
-    "type-fest": "^4.0.0"
+    "type-fest": "^4.0.0",
+    "zod": "^4.0.0"
   },
   "devDependencies": {
     "@apify/oxlint-config": "^0.3.0",
@@ -103,7 +106,9 @@
     "build": "pnpm clean && pnpm build:node && pnpm build:browser",
     "postbuild": "gen-esm-wrapper dist/index.js dist/index.mjs",
     "clean": "rimraf dist tsconfig.tsbuildinfo",
-    "test": "pnpm build && vitest run",
+    "test": "pnpm build && vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:all": "pnpm build && vitest run",
     "test:bundling": "pnpm build && pnpm --prefix=./test/bundling run bundle:all",
     "lint": "oxlint --type-aware",
     "lint:fix": "oxlint --type-aware --fix",