apify-client 3.0.0-beta.9 → 3.0.0-beta.90

package/dist/schemas.d.ts

@@ -1,15 +1,379 @@
 /**
  * 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
+ * Most of these are the generated ones. This module is 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 accepts what the specification describes,
+ * 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.
  */
+import { z } from 'zod';
 export * from './generated/schemas.js';
+/** The API returns `actVersion.buildTag` as `null` for some builds, which the specification types as a string. */
+export declare const Build: () => z.ZodObject<{
+    id: z.ZodString;
+    actId: z.ZodString;
+    userId: z.ZodString;
+    startedAt: z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>;
+    finishedAt: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>>>;
+    status: z.ZodUnion<[z.ZodEnum<{
+        ABORTED: "ABORTED";
+        ABORTING: "ABORTING";
+        FAILED: "FAILED";
+        READY: "READY";
+        RUNNING: "RUNNING";
+        SUCCEEDED: "SUCCEEDED";
+        "TIMED-OUT": "TIMED-OUT";
+        "TIMING-OUT": "TIMING-OUT";
+    }>, z.ZodString]>;
+    meta: z.ZodObject<{
+        origin: z.ZodUnion<[z.ZodEnum<{
+            ACTOR: "ACTOR";
+            API: "API";
+            CI: "CI";
+            CLI: "CLI";
+            DEVELOPMENT: "DEVELOPMENT";
+            MCP: "MCP";
+            SCHEDULER: "SCHEDULER";
+            STANDBY: "STANDBY";
+            TEST: "TEST";
+            WEB: "WEB";
+            WEBHOOK: "WEBHOOK";
+        }>, z.ZodString]>;
+        clientIp: z.ZodOptional<z.ZodString>;
+        userAgent: z.ZodOptional<z.ZodString>;
+        githubActionsRunUrl: z.ZodOptional<z.ZodString>;
+        actorRunId: z.ZodOptional<z.ZodString>;
+        webhookDispatchId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    stats: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        durationMillis: z.ZodOptional<z.ZodInt>;
+        runTimeSecs: z.ZodOptional<z.ZodNumber>;
+        computeUnits: z.ZodOptional<z.ZodNumber>;
+        imageSizeBytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    }, z.core.$loose>>>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        useCache: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        betaPackages: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        memoryMbytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        diskMbytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        tag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        debug: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    }, z.core.$loose>>>;
+    usage: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        ACTOR_COMPUTE_UNITS: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>>;
+    usageTotalUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    usageUsd: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        ACTOR_COMPUTE_UNITS: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>>;
+    inputSchema: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    readme: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    changelog: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    exitCode: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    gitCommitId: z.ZodOptional<z.ZodString>;
+    gitBranchName: z.ZodOptional<z.ZodString>;
+    createdByOrganizationMemberUserId: z.ZodOptional<z.ZodString>;
+    buildNumber: z.ZodString;
+    imageDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    actorDefinition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        actorSpecification: z.ZodOptional<z.ZodLiteral<1>>;
+        name: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        buildTag: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodObject<{
+            templateId: z.ZodOptional<z.ZodString>;
+            generatedBy: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        environmentVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        dockerfile: z.ZodOptional<z.ZodString>;
+        dockerContextDir: z.ZodOptional<z.ZodString>;
+        readme: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        input: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        output: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        changelog: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        storages: z.ZodOptional<z.ZodObject<{
+            dataset: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            datasets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            keyValueStore: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>;
+        defaultMemoryMbytes: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+        minMemoryMbytes: z.ZodOptional<z.ZodInt>;
+        maxMemoryMbytes: z.ZodOptional<z.ZodInt>;
+        usesStandbyMode: z.ZodOptional<z.ZodBoolean>;
+        webServerSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        webServerMcpPath: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+    actVersion: z.ZodOptional<z.ZodObject<{
+        sourceType: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+            GITHUB_GIST: "GITHUB_GIST";
+            GIT_REPO: "GIT_REPO";
+            SOURCE_CODE: "SOURCE_CODE";
+            SOURCE_FILES: "SOURCE_FILES";
+            TARBALL: "TARBALL";
+        }>, z.ZodString]>>;
+        versionNumber: z.ZodOptional<z.ZodString>;
+        gitRepoUrl: z.ZodOptional<z.ZodString>;
+        sourceFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            format: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+                BASE64: "BASE64";
+                TEXT: "TEXT";
+            }>, z.ZodString]>>;
+            content: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+        }, z.core.$loose>>>;
+        gitHubGistUrl: z.ZodOptional<z.ZodString>;
+        tarballUrl: z.ZodOptional<z.ZodString>;
+        buildTag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** Response containing Actor build data. */
+export declare const BuildResponse: () => z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodString;
+        actId: z.ZodString;
+        userId: z.ZodString;
+        startedAt: z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>;
+        finishedAt: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>>>;
+        status: z.ZodUnion<[z.ZodEnum<{
+            ABORTED: "ABORTED";
+            ABORTING: "ABORTING";
+            FAILED: "FAILED";
+            READY: "READY";
+            RUNNING: "RUNNING";
+            SUCCEEDED: "SUCCEEDED";
+            "TIMED-OUT": "TIMED-OUT";
+            "TIMING-OUT": "TIMING-OUT";
+        }>, z.ZodString]>;
+        meta: z.ZodObject<{
+            origin: z.ZodUnion<[z.ZodEnum<{
+                ACTOR: "ACTOR";
+                API: "API";
+                CI: "CI";
+                CLI: "CLI";
+                DEVELOPMENT: "DEVELOPMENT";
+                MCP: "MCP";
+                SCHEDULER: "SCHEDULER";
+                STANDBY: "STANDBY";
+                TEST: "TEST";
+                WEB: "WEB";
+                WEBHOOK: "WEBHOOK";
+            }>, z.ZodString]>;
+            clientIp: z.ZodOptional<z.ZodString>;
+            userAgent: z.ZodOptional<z.ZodString>;
+            githubActionsRunUrl: z.ZodOptional<z.ZodString>;
+            actorRunId: z.ZodOptional<z.ZodString>;
+            webhookDispatchId: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>;
+        stats: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            durationMillis: z.ZodOptional<z.ZodInt>;
+            runTimeSecs: z.ZodOptional<z.ZodNumber>;
+            computeUnits: z.ZodOptional<z.ZodNumber>;
+            imageSizeBytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        }, z.core.$loose>>>;
+        options: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            useCache: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            betaPackages: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            memoryMbytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            diskMbytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            tag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            debug: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        }, z.core.$loose>>>;
+        usage: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            ACTOR_COMPUTE_UNITS: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$loose>>>;
+        usageTotalUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        usageUsd: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            ACTOR_COMPUTE_UNITS: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, z.core.$loose>>>;
+        inputSchema: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        readme: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        changelog: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        exitCode: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+        gitCommitId: z.ZodOptional<z.ZodString>;
+        gitBranchName: z.ZodOptional<z.ZodString>;
+        createdByOrganizationMemberUserId: z.ZodOptional<z.ZodString>;
+        buildNumber: z.ZodString;
+        imageDigest: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        actorDefinition: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            actorSpecification: z.ZodOptional<z.ZodLiteral<1>>;
+            name: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+            buildTag: z.ZodOptional<z.ZodString>;
+            meta: z.ZodOptional<z.ZodObject<{
+                templateId: z.ZodOptional<z.ZodString>;
+                generatedBy: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            environmentVariables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            dockerfile: z.ZodOptional<z.ZodString>;
+            dockerContextDir: z.ZodOptional<z.ZodString>;
+            readme: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            input: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            output: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            changelog: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            storages: z.ZodOptional<z.ZodObject<{
+                dataset: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                datasets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+                keyValueStore: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$loose>>;
+            defaultMemoryMbytes: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodInt]>>;
+            minMemoryMbytes: z.ZodOptional<z.ZodInt>;
+            maxMemoryMbytes: z.ZodOptional<z.ZodInt>;
+            usesStandbyMode: z.ZodOptional<z.ZodBoolean>;
+            webServerSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            webServerMcpPath: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+        actVersion: z.ZodOptional<z.ZodObject<{
+            sourceType: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+                GITHUB_GIST: "GITHUB_GIST";
+                GIT_REPO: "GIT_REPO";
+                SOURCE_CODE: "SOURCE_CODE";
+                SOURCE_FILES: "SOURCE_FILES";
+                TARBALL: "TARBALL";
+            }>, z.ZodString]>>;
+            versionNumber: z.ZodOptional<z.ZodString>;
+            gitRepoUrl: z.ZodOptional<z.ZodString>;
+            sourceFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                format: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+                    BASE64: "BASE64";
+                    TEXT: "TEXT";
+                }>, z.ZodString]>>;
+                content: z.ZodOptional<z.ZodString>;
+                name: z.ZodString;
+            }, z.core.$loose>>>;
+            gitHubGistUrl: z.ZodOptional<z.ZodString>;
+            tarballUrl: z.ZodOptional<z.ZodString>;
+            buildTag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+}, z.core.$loose>;
+/**
+ * The API returns `uiState` as `null` once an API update has changed the schedule's `cronExpression` or `timezone`,
+ * which the specification types as an object.
+ */
+export declare const Schedule: () => z.ZodObject<{
+    id: z.ZodString;
+    userId: z.ZodString;
+    name: z.ZodString;
+    cronExpression: z.ZodString;
+    timezone: z.ZodString;
+    isEnabled: z.ZodBoolean;
+    isExclusive: z.ZodBoolean;
+    createdAt: z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>;
+    modifiedAt: z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>;
+    nextRunAt: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>>>;
+    lastRunAt: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    notifications: z.ZodOptional<z.ZodObject<{
+        email: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    integrationTracking: z.ZodOptional<z.ZodObject<{
+        platform: z.ZodOptional<z.ZodString>;
+        appId: z.ZodOptional<z.ZodString>;
+        isAiTool: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>>;
+    actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"RUN_ACTOR">;
+        actorId: z.ZodString;
+        runInput: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            contentType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>>;
+        runOptions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            build: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            timeoutSecs: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            memoryMbytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            maxItems: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            maxTotalChargeUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            restartOnError: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            isMaxTotalChargeUsdSetByUser: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            forcePermissionLevel: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<{
+                FULL_PERMISSIONS: "FULL_PERMISSIONS";
+                LIMITED_PERMISSIONS: "LIMITED_PERMISSIONS";
+            }>, z.ZodString]>>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"RUN_ACTOR_TASK">;
+        actorTaskId: z.ZodString;
+        input: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$loose>], "type">>;
+    uiState: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        version: z.ZodOptional<z.ZodInt>;
+        data: z.ZodOptional<z.ZodObject<{
+            cronExpression: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+/** Response containing schedule data. */
+export declare const ScheduleResponse: () => z.ZodObject<{
+    data: z.ZodObject<{
+        id: z.ZodString;
+        userId: z.ZodString;
+        name: z.ZodString;
+        cronExpression: z.ZodString;
+        timezone: z.ZodString;
+        isEnabled: z.ZodBoolean;
+        isExclusive: z.ZodBoolean;
+        createdAt: z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>;
+        modifiedAt: z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>;
+        nextRunAt: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>>>;
+        lastRunAt: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodISODateTime, z.ZodCoercedDate<string>>>>;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        notifications: z.ZodOptional<z.ZodObject<{
+            email: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        integrationTracking: z.ZodOptional<z.ZodObject<{
+            platform: z.ZodOptional<z.ZodString>;
+            appId: z.ZodOptional<z.ZodString>;
+            isAiTool: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$loose>>;
+        actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"RUN_ACTOR">;
+            actorId: z.ZodString;
+            runInput: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                contentType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$loose>>>;
+            runOptions: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                build: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                timeoutSecs: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                memoryMbytes: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                maxItems: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+                maxTotalChargeUsd: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                restartOnError: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                isMaxTotalChargeUsdSetByUser: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+                forcePermissionLevel: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodEnum<{
+                    FULL_PERMISSIONS: "FULL_PERMISSIONS";
+                    LIMITED_PERMISSIONS: "LIMITED_PERMISSIONS";
+                }>, z.ZodString]>>>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>, z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"RUN_ACTOR_TASK">;
+            actorTaskId: z.ZodString;
+            input: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$loose>], "type">>;
+        uiState: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            version: z.ZodOptional<z.ZodInt>;
+            data: z.ZodOptional<z.ZodObject<{
+                cronExpression: z.ZodOptional<z.ZodString>;
+                timezone: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>;
+}, z.core.$loose>;

package/dist/schemas.js

@@ -1,15 +1,37 @@
 /**
  * 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
+ * Most of these are the generated ones. This module is 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 accepts what the specification describes,
+ * 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.
  */
+import { z } from 'zod';
+import * as generated from './generated/schemas.js';
+import { lazySchema } from './lazy_schema.js';
 export * from './generated/schemas.js';
+/** The API returns `actVersion.buildTag` as `null` for some builds, which the specification types as a string. */
+export const Build = lazySchema(() => {
+    const generatedBuild = generated.Build();
+    return generatedBuild.extend({
+        actVersion: generatedBuild.shape.actVersion
+            .unwrap()
+            .extend({ buildTag: z.string().nullable().optional() })
+            .optional(),
+    });
+});
+/** Response containing Actor build data. */
+export const BuildResponse = lazySchema(() => generated.BuildResponse().extend({ data: Build() }));
+/**
+ * The API returns `uiState` as `null` once an API update has changed the schedule's `cronExpression` or `timezone`,
+ * which the specification types as an object.
+ */
+export const Schedule = lazySchema(() => generated.Schedule().extend({ uiState: generated.ScheduleUiState().nullable().optional() }));
+/** Response containing schedule data. */
+export const ScheduleResponse = lazySchema(() => generated.ScheduleResponse().extend({ data: Schedule() }));

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,84 @@
+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;
+    /**
+     * Aborts the method. Once the signal aborts, the request in flight is ended, no retry or further poll
+     * follows, and the method rejects with the signal's `reason`.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * 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<{
+    long: "long";
+    medium: "medium";
+    noTimeout: "noTimeout";
+    short: "short";
+}>, z.ZodNumber]>>;
+/**
+ * Schema of {@link TimeoutOptions.signal}, for the methods that validate `signal` on its own.
+ * @internal
+ */
+export declare const optionalSignalSchema: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+/**
+ * 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<{
+        long: "long";
+        medium: "medium";
+        noTimeout: "noTimeout";
+        short: "short";
+    }>, z.ZodNumber]>>;
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+};
+/**
+ * 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<{
+        long: "long";
+        medium: "medium";
+        noTimeout: "noTimeout";
+        short: "short";
+    }>, z.ZodNumber]>>;
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+}, z.core.$strict>;

package/dist/timeouts.js

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+/** Default duration of the `short` timeout tier, in seconds. */
+export const DEFAULT_TIMEOUT_SHORT_SECS = 5;
+/** Default duration of the `medium` timeout tier, in seconds. */
+export const DEFAULT_TIMEOUT_MEDIUM_SECS = 30;
+/** Default duration of the `long` timeout tier, in seconds. */
+export const DEFAULT_TIMEOUT_LONG_SECS = 360;
+/** Default cap on the timeout of a single request attempt, in seconds. */
+export const DEFAULT_TIMEOUT_MAX_SECS = 360;
+/**
+ * Schema of {@link Timeout}. Zero is rejected on purpose - `'noTimeout'` is the explicit way to run without one.
+ */
+const timeoutSchema = z.union([z.enum(['short', 'medium', 'long', 'noTimeout']), z.number().positive()]);
+/**
+ * Schema of {@link Timeout}, optional, for the methods that validate `timeoutSecs` on its own.
+ * @internal
+ */
+export const optionalTimeoutSchema = timeoutSchema.optional();
+/**
+ * Schema of {@link TimeoutOptions.signal}, for the methods that validate `signal` on its own.
+ * @internal
+ */
+export const optionalSignalSchema = z.instanceof(AbortSignal).optional();
+/**
+ * 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 const timeoutOptionsShape = {
+    timeoutSecs: optionalTimeoutSchema,
+    signal: optionalSignalSchema,
+};
+/**
+ * Schema of {@link TimeoutOptions}, for the methods that take no other option.
+ * @internal
+ */
+export const timeoutOptionsSchema = z.strictObject(timeoutOptionsShape);