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

package/dist/index.d.ts

@@ -27,6 +27,6 @@ export * from './resource_clients/webhook_collection.js';
 export * from './resource_clients/webhook_dispatch.js';
 export * from './resource_clients/webhook_dispatch_collection.js';
 export * from './apify_api_error.js';
-export * from './argument_validation_error.js';
+export { ArgumentValidationError } from '@apify/validations';
 export { InvalidResponseBodyError } from './interceptors.js';
 export type { PaginatedList, Dictionary } from './utils.js';

package/dist/index.js

@@ -27,5 +27,5 @@ export * from './resource_clients/webhook_collection.js';
 export * from './resource_clients/webhook_dispatch.js';
 export * from './resource_clients/webhook_dispatch_collection.js';
 export * from './apify_api_error.js';
-export * from './argument_validation_error.js';
+export { ArgumentValidationError } from '@apify/validations';
 export { InvalidResponseBodyError } from './interceptors.js';

package/dist/utils.d.ts

@@ -2,17 +2,10 @@ import type { Readable } from 'node:stream';
 import type { JsonValue, TypedArray } from 'type-fest';
 import { z } from 'zod';
 import type { ApifyApiError } from './apify_api_error.js';
+import { parseArgument } from '@apify/validations';
 import type { RequestQueueClientListRequestsOptions, RequestQueueClientListRequestsResult } from './resource_clients/request_queue.js';
 import type { WebhookUpdateData } from './resource_clients/webhook.js';
-/**
- * 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>;
+export { parseArgument };
 /**
  * Accepts any non-null, non-array object as a predicate for `z.custom()`.
  * @internal
@@ -210,4 +203,3 @@ export declare function toPathSegment(value: string): string;
  * `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,30 +1,12 @@
 import { z } from 'zod';
-import { ArgumentValidationError } from './argument_validation_error.js';
+import { parseArgument } from '@apify/validations';
 // @ts-ignore if we enable `resolveJsonModule`, we end up with a `src` folder in `dist`
 import packageJson from '../package.json' with { type: 'json' };
 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 } = 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
- */
-export function parseArgument(value, schema, label) {
-    const result = schema.safeParse(value, { error: localeError });
-    if (!result.success) {
-        throw new ArgumentValidationError(result.error, value, label);
-    }
-    return result.data;
-}
+export { parseArgument };
 /**
  * Accepts any non-null, non-array object as a predicate for `z.custom()`.
  * @internal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apify-client",
-  "version": "3.0.0-beta.2",
+  "version": "3.0.0-beta.4",
   "description": "Apify API client for JavaScript",
   "engines": {
     "node": ">=22.0.0"
@@ -57,48 +57,49 @@
     }
   },
   "dependencies": {
-    "@apify/consts": "^2.50.0",
-    "@apify/log": "^2.2.6",
-    "@apify/utilities": "^2.23.2",
-    "@crawlee/types": "^3.3.0",
-    "ansi-colors": "^4.1.1",
+    "@apify/consts": "^3.0.1",
+    "@apify/log": "^3.0.1",
+    "@apify/utilities": "^3.0.1",
+    "@apify/validations": "^1.1.0",
+    "@crawlee/types": "^3.18.1",
+    "ansi-colors": "^4.1.3",
     "async-retry": "^1.3.3",
-    "axios": "^1.16.0",
+    "axios": "^1.20.0",
     "content-type": "^1.0.5",
     "proxy-agent": "^6.5.0",
-    "tslib": "^2.5.0",
-    "type-fest": "^4.0.0",
-    "zod": "^4.0.0"
+    "tslib": "^2.8.1",
+    "type-fest": "^4.41.0",
+    "zod": "^4.5.4"
   },
   "devDependencies": {
     "@apify/oxlint-config": "^0.3.0",
     "@apify/tsconfig": "^0.2.0",
-    "@crawlee/puppeteer": "^3.2.2",
-    "@rsbuild/core": "^2.0.0",
-    "@rsbuild/plugin-node-polyfill": "^1.3.0",
-    "@rspack/cli": "^2.0.0",
-    "@rspack/core": "^2.0.0",
-    "@types/async-retry": "^1.4.5",
+    "@crawlee/puppeteer": "4.0.0-beta.165",
+    "@rsbuild/core": "^2.2.3",
+    "@rsbuild/plugin-node-polyfill": "^1.4.6",
+    "@rspack/cli": "^2.2.2",
+    "@rspack/core": "^2.2.2",
+    "@types/async-retry": "^1.4.9",
     "@types/compression": "^1.8.1",
-    "@types/content-type": "^1.1.5",
-    "@types/express": "^5.0.0",
-    "@types/node": "^24.0.0",
-    "ajv": "^8.17.1",
-    "body-parser": "^2.0.0",
-    "compression": "^1.7.4",
+    "@types/content-type": "^1.1.9",
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.13.3",
+    "ajv": "^8.20.0",
+    "body-parser": "^2.3.0",
+    "compression": "^1.8.1",
     "esbuild": "0.28.2",
-    "express": "^5.0.0",
+    "express": "^5.2.1",
     "openapi-typescript": "7.13.0",
-    "oxfmt": "0.65.0",
-    "oxlint": "1.79.0",
+    "oxfmt": "0.66.0",
+    "oxlint": "1.81.0",
     "oxlint-tsgolint": "7.0.2001",
-    "puppeteer": "^25.0.0",
-    "rimraf": "^6.0.0",
-    "rolldown": "^1.0.0-rc.4",
-    "typescript": "^6.0.0",
-    "vitest": "^4.0.16",
-    "webpack": "^5.105.2",
-    "webpack-cli": "^7.0.0"
+    "puppeteer": "^25.10.0",
+    "rimraf": "^6.1.3",
+    "rolldown": "^1.2.7",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.0",
+    "webpack": "^5.110.3",
+    "webpack-cli": "^7.2.3"
   },
   "devEngines": {
     "packageManager": {

package/dist/argument_validation_error.d.ts

@@ -1,17 +0,0 @@
-import type { z } from 'zod';
-/**
- * Thrown when an argument fails schema validation.
- *
- * Its `message` is a human-readable sentence naming the offending field and the
- * value it received (rather than a raw JSON dump). The structured
- * {@link https://zod.dev | zod} issues are available on `issues`, and the
- * original `ZodError` on `cause`, for programmatic inspection.
- *
- * `apify-client` sits below `@crawlee/core` and the Apify SDK in the dependency
- * graph, so it defines its own error type rather than importing one from them.
- */
-export declare class ArgumentValidationError extends Error {
-    /** Structured issues from the underlying schema check. */
-    readonly issues: z.ZodError['issues'];
-    constructor(error: z.ZodError, value: unknown, label?: string);
-}

package/dist/argument_validation_error.js

@@ -1,153 +0,0 @@
-/** Formats a zod issue path like `groups[0]` or `countryCode`. */
-function formatIssuePath(path) {
-    let out = '';
-    for (const key of path) {
-        if (typeof key === 'number')
-            out += `[${key}]`;
-        else
-            out += out ? `.${String(key)}` : String(key);
-    }
-    return out;
-}
-/** Reads the value at `path` from the validated input, to include in the error. */
-function valueAtPath(root, path) {
-    let current = root;
-    for (const key of path) {
-        if (current === null || typeof current !== 'object')
-            return undefined;
-        current = current[key];
-    }
-    return current;
-}
-/**
- * How much of a received string the message renders. A rejected argument can be arbitrarily large - a
- * whole JSON payload passed where an object was expected - and its full text would swamp the message.
- */
-const MAX_RECEIVED_STRING_LENGTH = 80;
-/** Renders a primitive received value for an error; skips objects/Dates (noisy). */
-function describeReceived(value) {
-    switch (typeof value) {
-        case 'string':
-            // An empty string would render as bare backticks - make it visible.
-            if (value === '')
-                return "''";
-            return value.length > MAX_RECEIVED_STRING_LENGTH
-                ? `${value.slice(0, MAX_RECEIVED_STRING_LENGTH)}...`
-                : value;
-        case 'number':
-        case 'boolean':
-            return String(value);
-        case 'bigint':
-            // Keep the `n` suffix, so a rejected bigint is not mistaken for a number.
-            return `${value}n`;
-        default:
-            return undefined;
-    }
-}
-/**
- * Renders the issue's own sentence, except where zod's contradicts itself: a value of the expected type
- * that fails that type's implicit constraint is still reported as the wrong *type*, giving "expected
- * number, received number" for `Infinity` / `NaN` and "expected date, received Date" for an invalid
- * `Date`. Name the constraint that actually failed instead.
- */
-function describeIssue(issue, value) {
-    if (issue.code === 'invalid_type') {
-        if (issue.expected === 'number' && typeof value === 'number') {
-            return 'Invalid input: expected a finite number';
-        }
-        // A tag check, not `instanceof`, so a `Date` from another realm is named too.
-        if (issue.expected === 'date' && Object.prototype.toString.call(value) === '[object Date]') {
-            return 'Invalid input: expected a valid date';
-        }
-    }
-    return issue.message;
-}
-/**
- * How many issue lines the message renders, before a closing "... and N more" line. Validating a
- * large array - a dataset push, a request batch - can fail on every element, and rendering all of
- * them would make the message megabytes long. The full set stays on `issues` either way.
- */
-const MAX_RENDERED_LINES = 10;
-/**
- * How deep into the value the lines for `issue` would sit, as a path length. Computed without
- * rendering anything, so a union can weigh its arms before any string is built.
- */
-function deepestIssueDepth(issue, baseDepth) {
-    const depth = baseDepth + issue.path.length;
-    if (issue.code === 'invalid_union') {
-        let deepest = -1;
-        for (const arm of issue.errors) {
-            for (const nested of arm)
-                deepest = Math.max(deepest, deepestIssueDepth(nested, depth));
-        }
-        return deepest;
-    }
-    return depth;
-}
-/** Collects one line per issue into `lines`; a union expands into a line per deepest-failing arm. */
-function collectIssueLines(issue, root, basePath, lines, counter) {
-    const path = [...basePath, ...issue.path];
-    // A union's own message is a bare "Invalid input" - the useful part is in `errors`,
-    // whose paths are relative to the union, hence passing `path` down as the base.
-    if (issue.code === 'invalid_union') {
-        // Only the arms that reached deepest are reported. An arm that failed nearer the root rejected a
-        // shape the value never had - for `[{ ok: 1 }, 2]` against `object | string | array`, the object
-        // and string arms fail on the whole array, and only the array arm can point at `[1]`. When every
-        // arm fails at the same depth, as for an argument of an outright wrong type, they are all kept.
-        const armDepths = issue.errors.map((arm) => arm.reduce((deepest, nested) => Math.max(deepest, deepestIssueDepth(nested, path.length)), -1));
-        const deepest = Math.max(...armDepths);
-        for (const [index, arm] of issue.errors.entries()) {
-            if (armDepths[index] !== deepest)
-                continue;
-            for (const nested of arm)
-                collectIssueLines(nested, root, path, lines, counter);
-        }
-        return;
-    }
-    counter.total += 1;
-    if (lines.length >= MAX_RENDERED_LINES)
-        return;
-    const location = path.length ? ` at \`${formatIssuePath(path)}\`` : '';
-    const value = valueAtPath(root, path);
-    const received = describeReceived(value);
-    const got = received === undefined ? '' : `, got \`${received}\``;
-    lines.push(`${describeIssue(issue, value)}${location}${got}`);
-}
-/**
- * Formats a `ZodError` as a plain, human-readable message that names the
- * offending field *and* the value it received (e.g. ``must match pattern
- * /^[A-Z]{2}$/ at `countryCode`, got `CZE` ``) - closer to the old `ow` errors
- * than zod's default, which omits the received value.
- */
-function formatZodError(error, root, label) {
-    const lines = [];
-    const counter = { total: 0 };
-    for (const issue of error.issues)
-        collectIssueLines(issue, root, [], lines, counter);
-    // The label names the validated interface, the way ow's errors ended with "in object `X`".
-    const rendered = label ? lines.map((line) => `${line} in \`${label}\``) : [...lines];
-    const hidden = counter.total - lines.length;
-    if (hidden > 0)
-        rendered.push(`... and ${hidden} more problem${hidden === 1 ? '' : 's'}`);
-    return rendered.join('\n');
-}
-/**
- * Thrown when an argument fails schema validation.
- *
- * Its `message` is a human-readable sentence naming the offending field and the
- * value it received (rather than a raw JSON dump). The structured
- * {@link https://zod.dev | zod} issues are available on `issues`, and the
- * original `ZodError` on `cause`, for programmatic inspection.
- *
- * `apify-client` sits below `@crawlee/core` and the Apify SDK in the dependency
- * graph, so it defines its own error type rather than importing one from them.
- */
-export class ArgumentValidationError extends Error {
-    /** Structured issues from the underlying schema check. */
-    issues;
-    constructor(error, value, label) {
-        super(formatZodError(error, value, label), { cause: error });
-        this.name = 'ArgumentValidationError';
-        this.issues = error.issues;
-    }
-}