apify-client 3.0.0-beta.70 → 3.0.0-beta.71

package/dist/generated/schemas.js

@@ -57,10 +57,13 @@ export const ErrorDetail = lazySchema(() => z.looseObject({
 export const ErrorResponse = lazySchema(() => z.looseObject({
     error: ErrorDetail(),
 }));
-export const VersionSourceType = lazySchema(() => z.enum(["SOURCE_FILES", "GIT_REPO", "TARBALL", "GITHUB_GIST", "SOURCE_CODE"]).or(z.string()));
-export const EnvVar = lazySchema(() => z.looseObject({
+/** Determines the permission level that the Actor requires to run. For details, see [Actor permissions](https://docs.apify.com/platform/actors/development/permissions). */
+export const ActorPermissionLevel = lazySchema(() => z.enum(["LIMITED_PERMISSIONS", "FULL_PERMISSIONS"]).or(z.string()));
+/** The version source types accepted in request bodies. Same as `VersionSourceType`, without `SOURCE_CODE`. */
+export const WritableVersionSourceType = lazySchema(() => z.enum(["SOURCE_FILES", "GIT_REPO", "TARBALL", "GITHUB_GIST"]).or(z.string()));
+export const EnvVarRequest = lazySchema(() => z.looseObject({
     name: z.string(),
-    value: z.string().optional(),
+    value: z.string(),
     isSecret: z.boolean().nullable().optional(),
 }));
 export const SourceCodeFileFormat = lazySchema(() => z.enum(["BASE64", "TEXT"]).or(z.string()));
@@ -79,19 +82,17 @@ export const SourceCodeFolder = lazySchema(() => z.looseObject({
     folder: z.boolean(),
 }));
 export const VersionSourceFiles = lazySchema(() => z.array(z.union([SourceCodeFile(), SourceCodeFolder()])));
-export const Version = lazySchema(() => z.looseObject({
+export const CreateVersionRequest = lazySchema(() => z.looseObject({
     versionNumber: z.string().regex(/^([0-9]|[1-9][0-9])\.([0-9]|[1-9][0-9])$/),
-    sourceType: VersionSourceType().nullable(),
-    envVars: z.array(EnvVar()).nullable().optional(),
+    sourceType: WritableVersionSourceType(),
+    envVars: z.array(EnvVarRequest()).optional(),
     applyEnvVarsToBuild: z.boolean().nullable().optional(),
     buildTag: z.string().nullable().optional(),
     sourceFiles: VersionSourceFiles().optional(),
-    gitRepoUrl: z.string().nullable().optional(),
-    tarballUrl: z.string().nullable().optional(),
-    gitHubGistUrl: z.string().nullable().optional(),
+    gitRepoUrl: z.string().optional(),
+    tarballUrl: z.string().optional(),
+    gitHubGistUrl: z.string().optional(),
 }));
-/** Determines the permission level that the Actor requires to run. For details, see [Actor permissions](https://docs.apify.com/platform/actors/development/permissions). */
-export const ActorPermissionLevel = lazySchema(() => z.enum(["LIMITED_PERMISSIONS", "FULL_PERMISSIONS"]).or(z.string()));
 /** The default settings applied to an Actor run. Can be overridden elsewhere. */
 export const DefaultRunOptions = lazySchema(() => z.looseObject({
     build: z.string().optional(),
@@ -119,17 +120,35 @@ export const CreateActorRequest = lazySchema(() => z.looseObject({
     name: z.string().nullable().optional(),
     description: z.string().nullable().optional(),
     title: z.string().nullable().optional(),
-    isPublic: z.boolean().nullable().optional(),
+    isPublic: z.boolean().optional(),
+    actorPermissionLevel: ActorPermissionLevel().optional(),
     seoTitle: z.string().nullable().optional(),
     seoDescription: z.string().nullable().optional(),
     restartOnError: z.boolean().optional(),
-    versions: z.array(Version()).nullable().optional(),
+    versions: z.array(CreateVersionRequest()).min(1).optional(),
     categories: z.array(z.string()).nullable().optional(),
     defaultRunOptions: DefaultRunOptions().optional(),
     actorStandby: ActorStandby().nullable().optional(),
     exampleRunInput: ExampleRunInput().nullable().optional(),
     isDeprecated: z.boolean().nullable().optional(),
 }));
+export const VersionSourceType = lazySchema(() => z.enum(["SOURCE_FILES", "GIT_REPO", "TARBALL", "GITHUB_GIST", "SOURCE_CODE"]).or(z.string()));
+export const EnvVar = lazySchema(() => z.looseObject({
+    name: z.string(),
+    value: z.string().optional(),
+    isSecret: z.boolean().nullable().optional(),
+}));
+export const Version = lazySchema(() => z.looseObject({
+    versionNumber: z.string().regex(/^([0-9]|[1-9][0-9])\.([0-9]|[1-9][0-9])$/),
+    sourceType: VersionSourceType().nullable(),
+    envVars: z.array(EnvVar()).nullable().optional(),
+    applyEnvVarsToBuild: z.boolean().nullable().optional(),
+    buildTag: z.string().nullable().optional(),
+    sourceFiles: VersionSourceFiles().optional(),
+    gitRepoUrl: z.string().nullable().optional(),
+    tarballUrl: z.string().nullable().optional(),
+    gitHubGistUrl: z.string().nullable().optional(),
+}));
 export const CommonActorPricingInfo = lazySchema(() => z.looseObject({
     apifyMarginPercentage: z.number(),
     createdAt: z.iso.datetime({ offset: true }).pipe(z.coerce.date()),
@@ -240,17 +259,6 @@ export const ActorResource = lazySchema(() => z.looseObject({
 export const ActorResponse = lazySchema(() => z.looseObject({
     data: ActorResource(),
 }));
-export const CreateOrUpdateVersionRequest = lazySchema(() => z.looseObject({
-    versionNumber: z.string().regex(/^([0-9]|[1-9][0-9])\.([0-9]|[1-9][0-9])$/).nullable().optional(),
-    sourceType: VersionSourceType().nullable().optional(),
-    envVars: z.array(EnvVar()).nullable().optional(),
-    applyEnvVarsToBuild: z.boolean().nullable().optional(),
-    buildTag: z.string().nullable().optional(),
-    sourceFiles: VersionSourceFiles().optional(),
-    gitRepoUrl: z.string().nullable().optional(),
-    tarballUrl: z.string().nullable().optional(),
-    gitHubGistUrl: z.string().nullable().optional(),
-}));
 /** The name of the build tag. */
 export const UpdatedBuildProperty = lazySchema(() => z.looseObject({
     buildId: z.string(),
@@ -259,12 +267,12 @@ export const UpdateActorRequest = lazySchema(() => z.looseObject({
     name: z.string().optional(),
     description: z.string().nullable().optional(),
     isPublic: z.boolean().optional(),
-    actorPermissionLevel: ActorPermissionLevel().nullable().optional(),
+    actorPermissionLevel: ActorPermissionLevel().optional(),
     seoTitle: z.string().nullable().optional(),
     seoDescription: z.string().nullable().optional(),
     title: z.string().nullable().optional(),
     restartOnError: z.boolean().optional(),
-    versions: z.array(CreateOrUpdateVersionRequest()).optional(),
+    versions: z.array(CreateVersionRequest()).min(1).optional(),
     pricingInfos: z.array(ActorRunPricingInfo()).optional(),
     categories: z.array(z.string()).nullable().optional(),
     defaultRunOptions: DefaultRunOptions().nullable().optional(),
@@ -283,6 +291,17 @@ export const ListOfVersionsResponse = lazySchema(() => z.looseObject({
 export const VersionResponse = lazySchema(() => z.looseObject({
     data: Version(),
 }));
+export const UpdateVersionRequest = lazySchema(() => z.looseObject({
+    versionNumber: z.string().regex(/^([0-9]|[1-9][0-9])\.([0-9]|[1-9][0-9])$/).optional(),
+    sourceType: WritableVersionSourceType().optional(),
+    envVars: z.array(EnvVarRequest()).optional(),
+    applyEnvVarsToBuild: z.boolean().nullable().optional(),
+    buildTag: z.string().nullable().optional(),
+    sourceFiles: VersionSourceFiles().optional(),
+    gitRepoUrl: z.string().optional(),
+    tarballUrl: z.string().optional(),
+    gitHubGistUrl: z.string().optional(),
+}));
 export const ListOfEnvVars = lazySchema(() => z.looseObject({
     total: z.int(),
     items: z.array(EnvVar()),
@@ -290,7 +309,6 @@ export const ListOfEnvVars = lazySchema(() => z.looseObject({
 export const ListOfEnvVarsResponse = lazySchema(() => z.looseObject({
     data: ListOfEnvVars(),
 }));
-export const EnvVarRequest = lazySchema(() => EnvVar().required({ value: true }));
 export const EnvVarResponse = lazySchema(() => z.looseObject({
     data: EnvVar(),
 }));
@@ -1228,6 +1246,10 @@ export const ListOfSchedules = lazySchema(() => PaginationResponse().extend({
 export const ListOfSchedulesResponse = lazySchema(() => z.looseObject({
     data: ListOfSchedules(),
 }));
+/** Notification settings for this schedule. */
+export const ScheduleNotifications = lazySchema(() => z.looseObject({
+    email: z.boolean().optional(),
+}));
 export const ScheduleActionRunInput = lazySchema(() => z.looseObject({
     body: z.string().nullable().optional(),
     contentType: z.string().nullable().optional(),
@@ -1252,6 +1274,7 @@ export const CreateOrUpdateScheduleRequest = lazySchema(() => z.looseObject({
     timezone: z.string().nullable().optional(),
     description: z.string().nullable().optional(),
     title: z.string().nullable().optional(),
+    notifications: ScheduleNotifications().optional(),
     actions: z.array(ScheduleCreateAction()).nullable().optional(),
 }));
 export const ScheduleActionRunActor = lazySchema(() => z.looseObject({
@@ -1271,9 +1294,7 @@ export const ScheduleAction = lazySchema(() => z.discriminatedUnion("type", [Sch
 export const Schedule = lazySchema(() => ScheduleBase().extend({
     description: z.string().nullable().optional(),
     title: z.string().nullable().optional(),
-    notifications: z.looseObject({
-        email: z.boolean().optional(),
-    }).optional(),
+    notifications: ScheduleNotifications().optional(),
     actions: z.array(ScheduleAction()),
 }));
 export const ScheduleResponse = lazySchema(() => z.looseObject({

package/dist/models.d.ts

@@ -437,6 +437,7 @@ export interface ActorListItem extends Omit<Schemas['ActorListItem'], keyof Acto
 type GeneratedBuildUsage = Schemas['BuildUsage'];
 type GeneratedBuildStats = Schemas['BuildStats'];
 type GeneratedBuildOptions = Schemas['BuildOptions'];
+type GeneratedBuildActVersion = NonNullable<Schemas['Build']['actVersion']>;
 /**
  * Resource usage for an Actor build.
  * @since Added in 2.7.2
@@ -463,6 +464,10 @@ export interface BuildRePointed {
     usageUsd?: BuildUsage | null;
     actorDefinition?: ActorDefinition | null;
     status: ValueOf<typeof ACTOR_JOB_STATUSES>;
+    /** The API returns `buildTag` as `null` for some builds, which the specification types as a string. */
+    actVersion?: Omit<GeneratedBuildActVersion, 'buildTag'> & {
+        buildTag?: string | null;
+    };
 }
 /**
  * Represents an Actor build.

package/dist/schemas.d.ts

@@ -1,9 +1,9 @@
 /**
  * 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 produces what the specification describes,
@@ -12,4 +12,201 @@
  * 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>;
+    }, 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>>;
+    }, 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>>;
+    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>;
+        version: z.ZodOptional<z.ZodString>;
+        buildTag: z.ZodOptional<z.ZodString>;
+        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>>>;
+        changelog: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        storages: z.ZodOptional<z.ZodObject<{
+            dataset: 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>;
+    }, 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>>>;
+        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>;
+        }, 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>>;
+        }, 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>>;
+        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>;
+            version: z.ZodOptional<z.ZodString>;
+            buildTag: z.ZodOptional<z.ZodString>;
+            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>>>;
+            changelog: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            storages: z.ZodOptional<z.ZodObject<{
+                dataset: 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>;
+        }, 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>>>;
+            buildTag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>;
+}, z.core.$loose>;

package/dist/schemas.js

@@ -1,9 +1,9 @@
 /**
  * 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 produces what the specification describes,
@@ -12,4 +12,19 @@
  * 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() }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apify-client",
-  "version": "3.0.0-beta.70",
+  "version": "3.0.0-beta.71",
   "description": "Apify API client for JavaScript",
   "engines": {
     "node": ">=22.13.0"