@transloadit/zod 4.2.0 → 4.3.1

package/dist/v4/robots/dropbox-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dropbox-store.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/dropbox-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAqClB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBrC,CAAA;AAEX,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM5D,CAAA;AAEJ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AACpG,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7D,CAAA;AACD,MAAM,MAAM,2CAA2C,GACrD,gDAAgD,CAAA;AAElD,MAAM,MAAM,gDAAgD,GAAG,CAAC,CAAC,KAAK,CACpE,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7E,CAAA;AACD,MAAM,MAAM,2DAA2D,GAAG,CAAC,CAAC,KAAK,CAC/E,OAAO,iEAAiE,CACzE,CAAA;AACD,MAAM,MAAM,gEAAgE,GAAG,CAAC,CAAC,KAAK,CACpF,OAAO,iEAAiE,CACzE,CAAA"}
+{"version":3,"file":"dropbox-store.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/dropbox-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAoClB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBrC,CAAA;AAEX,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM5D,CAAA;AAEJ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AACpG,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7D,CAAA;AACD,MAAM,MAAM,2CAA2C,GACrD,gDAAgD,CAAA;AAElD,MAAM,MAAM,gDAAgD,GAAG,CAAC,CAAC,KAAK,CACpE,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7E,CAAA;AACD,MAAM,MAAM,2DAA2D,GAAG,CAAC,CAAC,KAAK,CAC/E,OAAO,iEAAiE,CACzE,CAAA;AACD,MAAM,MAAM,gEAAgE,GAAG,CAAC,CAAC,KAAK,CACpF,OAAO,iEAAiE,CACzE,CAAA"}

package/dist/v4/robots/dropbox-store.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v4';
 import { dropboxBase, interpolateRobot, robotBase, robotUse } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 6,
     discount_factor: 0.15000150001500018,
     discount_pct: 84.99984999849998,

package/dist/v4/robots/edgly-deliver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edgly-deliver.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/edgly-deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cA4BlB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;kBAMrC,CAAA;AAEX,eAAO,MAAM,mDAAmD;;;;;;;;;;;;kBAK5D,CAAA;AAEJ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,iDAAiD;;;;;;;;;;;;kBAE7D,CAAA;AACD,MAAM,MAAM,2CAA2C,GACrD,gDAAgD,CAAA;AAElD,MAAM,MAAM,gDAAgD,GAAG,CAAC,CAAC,KAAK,CACpE,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,iEAAiE;;;;;;;;;;;;kBAE7E,CAAA;AACD,MAAM,MAAM,2DAA2D,GAAG,CAAC,CAAC,KAAK,CAC/E,OAAO,iEAAiE,CACzE,CAAA;AACD,MAAM,MAAM,gEAAgE,GAAG,CAAC,CAAC,KAAK,CACpF,OAAO,iEAAiE,CACzE,CAAA"}
+{"version":3,"file":"edgly-deliver.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/edgly-deliver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAmClB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;kBAMrC,CAAA;AAEX,eAAO,MAAM,mDAAmD;;;;;;;;;;;;kBAK5D,CAAA;AAEJ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,iDAAiD;;;;;;;;;;;;kBAE7D,CAAA;AACD,MAAM,MAAM,2CAA2C,GACrD,gDAAgD,CAAA;AAElD,MAAM,MAAM,gDAAgD,GAAG,CAAC,CAAC,KAAK,CACpE,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,iEAAiE;;;;;;;;;;;;kBAE7E,CAAA;AACD,MAAM,MAAM,2DAA2D,GAAG,CAAC,CAAC,KAAK,CAC/E,OAAO,iEAAiE,CACzE,CAAA;AACD,MAAM,MAAM,gEAAgE,GAAG,CAAC,CAAC,KAAK,CACpF,OAAO,iEAAiE,CACzE,CAAA"}

package/dist/v4/robots/edgly-deliver.js

@@ -1,10 +1,17 @@
 import { z } from 'zod/v4';
 import { interpolateRobot, robotBase } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: false,
     bytescount: 20,
     discount_factor: 0.05,
     discount_pct: 95,
+    example_code: {
+        steps: {
+            deliver: {
+                robot: '/edgly/deliver',
+            },
+        },
+    },
+    example_code_description: 'Cache and deliver files over Smart CDN using the edgly.net domain:',
     minimum_charge: 102400,
     output_factor: 1,
     override_lvl1: 'Content Delivery',

package/dist/v4/robots/file-compress.d.ts

@@ -40,6 +40,7 @@ export declare const robotFileCompressInstructionsSchema: z.ZodObject<{
         "relative-path": "relative-path";
     }>>;
     archive_name: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const robotFileCompressInstructionsWithHiddenFieldsSchema: z.ZodObject<{
     output_meta: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
@@ -79,6 +80,7 @@ export declare const robotFileCompressInstructionsWithHiddenFieldsSchema: z.ZodO
         "relative-path": "relative-path";
     }>>;
     archive_name: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
     result: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, z.core.$strict>;
 export type RobotFileCompressInstructions = z.infer<typeof robotFileCompressInstructionsSchema>;
@@ -122,6 +124,7 @@ export declare const interpolatableRobotFileCompressInstructionsSchema: z.ZodObj
         "relative-path": "relative-path";
     }>]>>;
     archive_name: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type InterpolatableRobotFileCompressInstructions = InterpolatableRobotFileCompressInstructionsInput;
 export type InterpolatableRobotFileCompressInstructionsInput = z.input<typeof interpolatableRobotFileCompressInstructionsSchema>;
@@ -163,6 +166,7 @@ export declare const interpolatableRobotFileCompressInstructionsWithHiddenFields
         "relative-path": "relative-path";
     }>]>>;
     archive_name: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
 }, z.core.$strict>;
 export type InterpolatableRobotFileCompressInstructionsWithHiddenFields = z.infer<typeof interpolatableRobotFileCompressInstructionsWithHiddenFieldsSchema>;

package/dist/v4/robots/file-compress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-compress.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-compress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cA0ElB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqDrC,CAAA;AAEX,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK5D,CAAA;AAEJ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7D,CAAA;AACD,MAAM,MAAM,2CAA2C,GACrD,gDAAgD,CAAA;AAElD,MAAM,MAAM,gDAAgD,GAAG,CAAC,CAAC,KAAK,CACpE,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7E,CAAA;AACD,MAAM,MAAM,2DAA2D,GAAG,CAAC,CAAC,KAAK,CAC/E,OAAO,iEAAiE,CACzE,CAAA;AACD,MAAM,MAAM,gEAAgE,GAAG,CAAC,CAAC,KAAK,CACpF,OAAO,iEAAiE,CACzE,CAAA"}
+{"version":3,"file":"file-compress.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-compress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAyElB,CAAA;AAED,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6DrC,CAAA;AAEX,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK5D,CAAA;AAEJ,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAC/F,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7D,CAAA;AACD,MAAM,MAAM,2CAA2C,GACrD,gDAAgD,CAAA;AAElD,MAAM,MAAM,gDAAgD,GAAG,CAAC,CAAC,KAAK,CACpE,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE7E,CAAA;AACD,MAAM,MAAM,2DAA2D,GAAG,CAAC,CAAC,KAAK,CAC/E,OAAO,iEAAiE,CACzE,CAAA;AACD,MAAM,MAAM,gEAAgE,GAAG,CAAC,CAAC,KAAK,CACpF,OAAO,iEAAiE,CACzE,CAAA"}

package/dist/v4/robots/file-compress.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v4';
 import { interpolateRobot, robotBase, robotUse } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: false,
     bytescount: 1,
     discount_factor: 1,
     discount_pct: 0,
@@ -126,6 +125,14 @@ Files with same names are numbered in the \`"simple"\` file layout to avoid nami
         .optional()
         .describe(`
 The name of the archive file to be created (without the file extension).
+`),
+    path: z
+        .string()
+        .optional()
+        .describe(`
+The path at which each file is to be placed inside the archive. This may include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables). Variables are evaluated per file, allowing templates like \`"\${file.meta.archive_directory}/\${file.name}"\` to preserve the original directory structure from a previously extracted archive.
+
+When this parameter is set, the \`file_layout\` parameter is ignored.
 `),
 })
     .strict();

package/dist/v4/robots/file-decompress.d.ts

@@ -23,10 +23,12 @@ export declare const robotFileDecompressInstructionsSchema: z.ZodObject<{
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/decompress">;
+    password: z.ZodOptional<z.ZodString>;
     ignore_errors: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
         meta: "meta";
         execute: "execute";
     }>>]>, z.ZodTransform<("meta" | "execute")[], boolean | ("meta" | "execute")[]>>>;
+    turbo: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const robotFileDecompressInstructionsWithHiddenFieldsSchema: z.ZodObject<{
     output_meta: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
@@ -49,10 +51,12 @@ export declare const robotFileDecompressInstructionsWithHiddenFieldsSchema: z.Zo
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/decompress">;
+    password: z.ZodOptional<z.ZodString>;
     ignore_errors: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
         meta: "meta";
         execute: "execute";
     }>>]>, z.ZodTransform<("meta" | "execute")[], boolean | ("meta" | "execute")[]>>>;
+    turbo: z.ZodDefault<z.ZodBoolean>;
     result: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, z.core.$strict>;
 export type RobotFileDecompressInstructions = z.infer<typeof robotFileDecompressInstructionsSchema>;
@@ -79,10 +83,12 @@ export declare const interpolatableRobotFileDecompressInstructionsSchema: z.ZodO
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/decompress">;
+    password: z.ZodOptional<z.ZodString>;
     ignore_errors: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
         meta: "meta";
         execute: "execute";
     }>>]>, z.ZodTransform<("meta" | "execute")[], boolean | ("meta" | "execute")[]>>]>>;
+    turbo: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
 }, z.core.$strict>;
 export type InterpolatableRobotFileDecompressInstructions = InterpolatableRobotFileDecompressInstructionsInput;
 export type InterpolatableRobotFileDecompressInstructionsInput = z.input<typeof interpolatableRobotFileDecompressInstructionsSchema>;
@@ -107,10 +113,12 @@ export declare const interpolatableRobotFileDecompressInstructionsWithHiddenFiel
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/decompress">;
+    password: z.ZodOptional<z.ZodString>;
     ignore_errors: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
         meta: "meta";
         execute: "execute";
     }>>]>, z.ZodTransform<("meta" | "execute")[], boolean | ("meta" | "execute")[]>>]>>;
+    turbo: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
 }, z.core.$strict>;
 export type InterpolatableRobotFileDecompressInstructionsWithHiddenFields = z.infer<typeof interpolatableRobotFileDecompressInstructionsWithHiddenFieldsSchema>;

package/dist/v4/robots/file-decompress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-decompress.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-decompress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAmClB,CAAA;AAED,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkDvC,CAAA;AAEX,eAAO,MAAM,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK9D,CAAA;AAEJ,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAA;AACnG,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,qDAAqD,CAC7D,CAAA;AAED,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE/D,CAAA;AACD,MAAM,MAAM,6CAA6C,GACvD,kDAAkD,CAAA;AAEpD,MAAM,MAAM,kDAAkD,GAAG,CAAC,CAAC,KAAK,CACtE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE/E,CAAA;AACD,MAAM,MAAM,6DAA6D,GAAG,CAAC,CAAC,KAAK,CACjF,OAAO,mEAAmE,CAC3E,CAAA;AACD,MAAM,MAAM,kEAAkE,GAAG,CAAC,CAAC,KAAK,CACtF,OAAO,mEAAmE,CAC3E,CAAA"}
+{"version":3,"file":"file-decompress.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-decompress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAkClB,CAAA;AAED,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4EvC,CAAA;AAEX,eAAO,MAAM,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK9D,CAAA;AAEJ,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAA;AACnG,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,qDAAqD,CAC7D,CAAA;AAED,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE/D,CAAA;AACD,MAAM,MAAM,6CAA6C,GACvD,kDAAkD,CAAA;AAEpD,MAAM,MAAM,kDAAkD,GAAG,CAAC,CAAC,KAAK,CACtE,OAAO,mDAAmD,CAC3D,CAAA;AAED,eAAO,MAAM,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE/E,CAAA;AACD,MAAM,MAAM,6DAA6D,GAAG,CAAC,CAAC,KAAK,CACjF,OAAO,mEAAmE,CAC3E,CAAA;AACD,MAAM,MAAM,kEAAkE,GAAG,CAAC,CAAC,KAAK,CACtF,OAAO,mEAAmE,CAC3E,CAAA"}

package/dist/v4/robots/file-decompress.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v4';
 import { interpolateRobot, robotBase, robotUse } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 1,
     discount_factor: 0.8,
     discount_pct: 20,
@@ -41,9 +40,9 @@ export const robotFileDecompressInstructionsSchema = robotBase
     robot: z.literal('/file/decompress').describe(`
 This Robot supports the following archive formats:
 
-- ZIP archives (with uncompressed or "deflate"-compressed entries)
-- 7-Zip archives
-- RAR archives
+- ZIP archives (with uncompressed or "deflate"-compressed entries, including password-protected)
+- 7-Zip archives (including AES-256 encrypted)
+- RAR archives (including encrypted)
 - GNU tar format (including GNU long filenames, long link names, and sparse files)
 - Solaris 9 extended tar format (including ACLs)
 - Old V7 tar archives
@@ -69,7 +68,21 @@ This <dfn>Robot</dfn> also detects and handles any of the following before evalu
 - compress/LZW compression
 - lzma, lzip, and xz compression
 
-For security reasons, archives that contain symlinks to outside the archived dir, will error out the <dfn>Assembly</dfn>. Decompressing password-protected archives (encrypted archives) is currently not fully supported but will not cause an <dfn>Assembly</dfn> to fail.
+For security reasons, archives that contain symlinks to outside the archived dir, will error out the <dfn>Assembly</dfn>.
+
+Password-protected archives (ZIP with ZipCrypto or AES encryption, RAR encrypted, 7z with AES-256) are supported via the \`password\` parameter.
+`),
+    password: z
+        .string()
+        .optional()
+        .describe(`
+The password to use for decrypting password-protected archives.
+
+Supports encrypted ZIP (ZipCrypto and AES), RAR (encrypted), and 7z (AES-256 encrypted) archives.
+
+For security, this value should be passed via Template Variables (\`\${fields.archive_password}\`) or Template Credentials rather than hardcoded in your Assembly Instructions. The password is never logged or included in Assembly status responses.
+
+If the archive is encrypted and no password is provided, or if the password is incorrect, the <dfn>Assembly</dfn> will fail with a \`FILE_DECOMPRESS_PASSWORD_REQUIRED\` or \`FILE_DECOMPRESS_PASSWORD_INCORRECT\` error.
 `),
     ignore_errors: z
         .union([z.boolean(), z.array(z.enum(['meta', 'execute']))])
@@ -81,6 +94,18 @@ A possible array member is only \`"meta"\`.
 You might see an error when trying to extract metadata from the files inside your archive. This happens, for example, for files with a size of zero bytes. Setting this to \`true\` will cause the <dfn>Robot</dfn> to not stop the file decompression (and the entire <dfn>Assembly</dfn>) when that happens.
 
 To keep backwards compatibility, setting this parameter to \`true\` will set it to \`["meta"]\` internally.
+`),
+    turbo: z
+        .boolean()
+        .default(true)
+        .describe(`
+Enables Turbo Mode for \`/file/decompress\`.
+
+This setting defaults to \`true\`. Set it to \`false\` to disable Turbo Mode.
+
+When enabled, extracted files are emitted as soon as they are available, which can speed up downstream processing for large archives.
+
+Turbo Mode also changes usage accounting: emitted extracted-file bytes and original input-archive bytes are billed with a surcharge (25% by default).
 `),
 })
     .strict();

package/dist/v4/robots/file-filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-filter.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,eAAO,MAAM,IAAI,EAAE,cAuClB,CAAA;AAED,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2FnC,CAAA;AAEX,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK1D,CAAA;AAEJ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAC3F,MAAM,MAAM,2CAA2C,GAAG,CAAC,CAAC,KAAK,CAC/D,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE3D,CAAA;AACD,MAAM,MAAM,yCAAyC,GACnD,8CAA8C,CAAA;AAEhD,MAAM,MAAM,8CAA8C,GAAG,CAAC,CAAC,KAAK,CAClE,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE3E,CAAA;AACD,MAAM,MAAM,yDAAyD,GAAG,CAAC,CAAC,KAAK,CAC7E,OAAO,+DAA+D,CACvE,CAAA;AACD,MAAM,MAAM,8DAA8D,GAAG,CAAC,CAAC,KAAK,CAClF,OAAO,+DAA+D,CACvE,CAAA"}
+{"version":3,"file":"file-filter.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,eAAO,MAAM,IAAI,EAAE,cAsClB,CAAA;AAED,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6GnC,CAAA;AAEX,eAAO,MAAM,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK1D,CAAA;AAEJ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAA;AAC3F,MAAM,MAAM,2CAA2C,GAAG,CAAC,CAAC,KAAK,CAC/D,OAAO,iDAAiD,CACzD,CAAA;AAED,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE3D,CAAA;AACD,MAAM,MAAM,yCAAyC,GACnD,8CAA8C,CAAA;AAEhD,MAAM,MAAM,8CAA8C,GAAG,CAAC,CAAC,KAAK,CAClE,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE3E,CAAA;AACD,MAAM,MAAM,yDAAyD,GAAG,CAAC,CAAC,KAAK,CAC7E,OAAO,+DAA+D,CACvE,CAAA;AACD,MAAM,MAAM,8DAA8D,GAAG,CAAC,CAAC,KAAK,CAClF,OAAO,+DAA+D,CACvE,CAAA"}

package/dist/v4/robots/file-filter.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v4';
 import { filterCondition, interpolateRobot, robotBase, robotUse, } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 0,
     discount_factor: 0,
     discount_pct: 100,
@@ -10,7 +9,7 @@ export const meta = {
             filtered: {
                 robot: '/file/filter',
                 use: ':original',
-                declines: [['${file.size}', '>', '20971520']],
+                declines: [['${file.size}', '>', '20mb']],
                 error_on_decline: true,
                 error_msg: 'File size must not exceed 20 MB',
             },
@@ -65,9 +64,21 @@ Examples:
 
 - \`[["\${file.meta.width}", ">", "\${file.meta.height}"]]\`
 - \`[["\${file.size}", "<=", "720"]]\`
+- \`[["\${file.size}", ">", "20mb"]]\`
 - \`[["720", ">=", "\${file.size}"]]\`
 - \`[["\${file.mime}", "regex", "image"]]\`
 
+When you match against \`\${file.mime}\`, the value is typically based on Transloadit’s
+server-side metadata extraction in the normal upload flow, rather than only the MIME type reported
+by the client or browser. This makes \`/file/filter\` suitable for rejecting mislabeled files.
+Depending on the file container and the detection tools involved, some formats may be reported under
+closely related MIME types such as \`image/heic\` or \`image/heif\`.
+
+If you only want formats that browsers consistently render, prefer an explicit allowlist such as
+\`^(image/jpeg|image/png|image/gif|image/webp|image/avif)$\` over a broad \`^image/\` rule.
+
+For numeric comparisons (\`<\`, \`>\`, \`<=\`, \`>=\`), you can use human-readable byte values such as \`"20mb"\`, \`"1gb"\`, or \`"512kb"\`. These use binary (1024-based) multipliers. Supported units: \`b\`, \`kb\`, \`mb\`, \`gb\`, \`tb\`, \`pb\` (and their IEC equivalents \`kib\`, \`mib\`, \`gib\`, \`tib\`, \`pib\`).
+
 The \`includes\` and \`!includes\` operators work with arrays or strings (strings use substring checks).
 
 > [!Warning]
@@ -88,9 +99,12 @@ As indicated, we charge for this via [🤖/script/run](/docs/robots/script-run/)
 `),
     accepts: filterCondition
         .describe(`
-Files that match at least one requirement will be accepted, or declined otherwise. If the value is \`null\`, all files will be accepted. If the array is empty, no files will be accepted. Example:
+Files that match at least one requirement will be accepted, or declined otherwise. If the value is \`null\`, all files will be accepted. If the array is empty, no files will be accepted. Examples:
 
-\`[["\${file.mime}", "==", "image/gif"]]\`.
+\`[["\${file.mime}", "==", "image/gif"]]\`
+\`[["\${file.size}", "<", "5kb"]]\`
+
+For numeric comparisons (\`<\`, \`>\`, \`<=\`, \`>=\`), human-readable byte values such as \`"20mb"\`, \`"1gb"\`, or \`"512kb"\` are supported.
 
 If the \`condition_type\` parameter is set to \`"and"\`, then all requirements must match for the file to be accepted.
 
@@ -99,9 +113,12 @@ If \`accepts\` and \`declines\` are both provided, the requirements in \`accepts
         .optional(),
     declines: filterCondition
         .describe(`
-Files that match at least one requirement will be declined, or accepted otherwise. If the value is \`null\` or an empty array, no files will be declined. Example:
+Files that match at least one requirement will be declined, or accepted otherwise. If the value is \`null\` or an empty array, no files will be declined. Examples:
+
+\`[["\${file.size}", ">", "1024"]]\`
+\`[["\${file.size}", ">", "20mb"]]\`
 
-\`[["\${file.size}",">","1024"]]\`.
+For numeric comparisons (\`<\`, \`>\`, \`<=\`, \`>=\`), human-readable byte values such as \`"20mb"\`, \`"1gb"\`, or \`"512kb"\` are supported.
 
 If the \`condition_type\` parameter is set to \`"and"\`, then all requirements must match for the file to be declined.
 

package/dist/v4/robots/file-hash.d.ts

@@ -36,6 +36,13 @@ export declare const robotFileHashInstructionsSchema: z.ZodObject<{
         sha384: "sha384";
         sha512: "sha512";
     }>>;
+    partial: z.ZodDefault<z.ZodEnum<{
+        full: "full";
+        last: "last";
+        first: "first";
+        both: "both";
+    }>>;
+    partial_size: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const robotFileHashInstructionsWithHiddenFieldsSchema: z.ZodObject<{
     output_meta: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
@@ -71,6 +78,13 @@ export declare const robotFileHashInstructionsWithHiddenFieldsSchema: z.ZodObjec
         sha384: "sha384";
         sha512: "sha512";
     }>>;
+    partial: z.ZodDefault<z.ZodEnum<{
+        full: "full";
+        last: "last";
+        first: "first";
+        both: "both";
+    }>>;
+    partial_size: z.ZodDefault<z.ZodNumber>;
     result: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, z.core.$strict>;
 export type RobotFileHashInstructions = z.infer<typeof robotFileHashInstructionsSchema>;
@@ -110,6 +124,13 @@ export declare const interpolatableRobotFileHashInstructionsSchema: z.ZodObject<
         sha384: "sha384";
         sha512: "sha512";
     }>]>>;
+    partial: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+        full: "full";
+        last: "last";
+        first: "first";
+        both: "both";
+    }>]>>;
+    partial_size: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
 }, z.core.$strict>;
 export type InterpolatableRobotFileHashInstructions = InterpolatableRobotFileHashInstructionsInput;
 export type InterpolatableRobotFileHashInstructionsInput = z.input<typeof interpolatableRobotFileHashInstructionsSchema>;
@@ -147,6 +168,13 @@ export declare const interpolatableRobotFileHashInstructionsWithHiddenFieldsSche
         sha384: "sha384";
         sha512: "sha512";
     }>]>>;
+    partial: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+        full: "full";
+        last: "last";
+        first: "first";
+        both: "both";
+    }>]>>;
+    partial_size: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
 }, z.core.$strict>;
 export type InterpolatableRobotFileHashInstructionsWithHiddenFields = z.infer<typeof interpolatableRobotFileHashInstructionsWithHiddenFieldsSchema>;

package/dist/v4/robots/file-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-hash.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAkClB,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAejC,CAAA;AAEX,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGxD,CAAA;AAEJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzD,CAAA;AACD,MAAM,MAAM,uCAAuC,GAAG,4CAA4C,CAAA;AAElG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,6CAA6C,CACrD,CAAA;AAED,eAAO,MAAM,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzE,CAAA;AACD,MAAM,MAAM,uDAAuD,GAAG,CAAC,CAAC,KAAK,CAC3E,OAAO,6DAA6D,CACrE,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,6DAA6D,CACrE,CAAA"}
+{"version":3,"file":"file-hash.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAiClB,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAsCjC,CAAA;AAEX,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGxD,CAAA;AAEJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzD,CAAA;AACD,MAAM,MAAM,uCAAuC,GAAG,4CAA4C,CAAA;AAElG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,6CAA6C,CACrD,CAAA;AAED,eAAO,MAAM,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzE,CAAA;AACD,MAAM,MAAM,uDAAuD,GAAG,CAAC,CAAC,KAAK,CAC3E,OAAO,6DAA6D,CACrE,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,6DAA6D,CACrE,CAAA"}

package/dist/v4/robots/file-hash.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v4';
 import { interpolateRobot, robotBase, robotUse } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: false,
     bytescount: 5,
     discount_factor: 0.2,
     discount_pct: 80,
@@ -48,6 +47,29 @@ This <dfn>Robot</dfn> allows you to hash any file as part of the <dfn>Assembly</
 The hashing algorithm to use.
 
 The file hash is exported as \`file.meta.hash\`.
+`),
+    partial: z
+        .enum(['full', 'first', 'last', 'both'])
+        .default('full')
+        .describe(`
+Specifies which portion of the file to hash. This is useful for fast fingerprinting of large files.
+
+- \`"full"\` (default): Hash the entire file.
+- \`"first"\`: Hash only the first N bytes (specified by \`partial_size\`).
+- \`"last"\`: Hash only the last N bytes (specified by \`partial_size\`).
+- \`"both"\`: Hash the first N bytes concatenated with the last N bytes.
+
+When using partial hashing, \`file.meta.hash_partial\` indicates the mode used, and \`file.meta.hash_partial_size\` indicates the number of bytes hashed from each portion.
+`),
+    partial_size: z
+        .number()
+        .int()
+        .positive()
+        .default(1048576)
+        .describe(`
+The number of bytes to hash when using partial hashing. Defaults to \`1048576\` (1 MB).
+
+This parameter is only used when \`partial\` is set to \`"first"\`, \`"last"\`, or \`"both"\`.
 `),
 })
     .strict();

package/dist/v4/robots/file-preview.d.ts

@@ -32,8 +32,8 @@ export declare const robotFilePreviewInstructionsSchema: z.ZodObject<{
         jpg: "jpg";
         png: "png";
     }>>;
-    width: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
-    height: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    width: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
+    height: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
     resize_strategy: z.ZodDefault<z.ZodEnum<{
         crop: "crop";
         fit: "fit";
@@ -43,6 +43,7 @@ export declare const robotFilePreviewInstructionsSchema: z.ZodObject<{
         stretch: "stretch";
     }>>;
     background: z.ZodDefault<z.ZodString>;
+    zoom: z.ZodDefault<z.ZodBoolean>;
     strategy: z.ZodOptional<z.ZodObject<{
         archive: z.ZodDefault<z.ZodArray<z.ZodString>>;
         audio: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -115,8 +116,8 @@ export declare const robotFilePreviewInstructionsWithHiddenFieldsSchema: z.ZodOb
         jpg: "jpg";
         png: "png";
     }>>;
-    width: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
-    height: z.ZodDefault<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>>;
+    width: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
+    height: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
     resize_strategy: z.ZodDefault<z.ZodEnum<{
         crop: "crop";
         fit: "fit";
@@ -126,6 +127,7 @@ export declare const robotFilePreviewInstructionsWithHiddenFieldsSchema: z.ZodOb
         stretch: "stretch";
     }>>;
     background: z.ZodDefault<z.ZodString>;
+    zoom: z.ZodDefault<z.ZodBoolean>;
     strategy: z.ZodOptional<z.ZodObject<{
         archive: z.ZodDefault<z.ZodArray<z.ZodString>>;
         audio: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -203,8 +205,8 @@ export declare const interpolatableRobotFilePreviewInstructionsSchema: z.ZodObje
         jpg: "jpg";
         png: "png";
     }>]>>;
-    width: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>>;
-    height: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>>;
+    width: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
+    height: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
     resize_strategy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         crop: "crop";
         fit: "fit";
@@ -214,6 +216,7 @@ export declare const interpolatableRobotFilePreviewInstructionsSchema: z.ZodObje
         stretch: "stretch";
     }>]>>;
     background: z.ZodDefault<z.ZodString>;
+    zoom: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     strategy: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
         archive: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;
         audio: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;
@@ -288,8 +291,8 @@ export declare const interpolatableRobotFilePreviewInstructionsWithHiddenFieldsS
         jpg: "jpg";
         png: "png";
     }>]>>;
-    width: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>>;
-    height: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodNumber>]>>;
+    width: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
+    height: z.ZodDefault<z.ZodPreprocess<z.ZodNumber>>;
     resize_strategy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
         crop: "crop";
         fit: "fit";
@@ -299,6 +302,7 @@ export declare const interpolatableRobotFilePreviewInstructionsWithHiddenFieldsS
         stretch: "stretch";
     }>]>>;
     background: z.ZodDefault<z.ZodString>;
+    zoom: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
     strategy: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
         archive: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;
         audio: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;

package/dist/v4/robots/file-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-preview.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAYnE,eAAO,MAAM,IAAI,EAAE,cAwClB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0KpC,CAAA;AAEX,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK3D,CAAA;AAEJ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAClG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,kDAAkD,CAC1D,CAAA;AAED,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE5D,CAAA;AACD,MAAM,MAAM,0CAA0C,GACpD,+CAA+C,CAAA;AAEjD,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE5E,CAAA;AACD,MAAM,MAAM,0DAA0D,GAAG,CAAC,CAAC,KAAK,CAC9E,OAAO,gEAAgE,CACxE,CAAA;AACD,MAAM,MAAM,+DAA+D,GAAG,CAAC,CAAC,KAAK,CACnF,OAAO,gEAAgE,CACxE,CAAA"}
+{"version":3,"file":"file-preview.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAYnE,eAAO,MAAM,IAAI,EAAE,cAuClB,CAAA;AAED,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkLpC,CAAA;AAEX,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAK3D,CAAA;AAEJ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAC7F,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAClG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,kDAAkD,CAC1D,CAAA;AAED,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE5D,CAAA;AACD,MAAM,MAAM,0CAA0C,GACpD,+CAA+C,CAAA;AAEjD,MAAM,MAAM,+CAA+C,GAAG,CAAC,CAAC,KAAK,CACnE,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE5E,CAAA;AACD,MAAM,MAAM,0DAA0D,GAAG,CAAC,CAAC,KAAK,CAC9E,OAAO,gEAAgE,CACxE,CAAA;AACD,MAAM,MAAM,+DAA+D,GAAG,CAAC,CAAC,KAAK,CACnF,OAAO,gEAAgE,CACxE,CAAA"}

package/dist/v4/robots/file-preview.js

@@ -1,7 +1,6 @@
 import { z } from 'zod/v4';
 import { color_with_alpha, complexHeightSchema, complexWidthSchema, interpolateRobot, optimize_priority, resize_strategy, robotBase, robotUse, } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 1,
     discount_factor: 1,
     discount_pct: 0,
@@ -69,6 +68,14 @@ See the list of available [resize strategies](/docs/topics/resize-strategies/) f
 `),
     background: color_with_alpha.default('#ffffffff').describe(`
 The hexadecimal code of the color used to fill the background (only used for the pad resize strategy). The format is \`#rrggbb[aa]\` (red, green, blue, alpha). Use \`#00000000\` for a transparent padding.
+`),
+    zoom: z
+        .boolean()
+        .default(true)
+        .describe(`
+If set to \`false\`, smaller images will not be stretched to the desired \`width\` and \`height\`. This is useful if you want to retain the original image dimensions and only limit the output to a maximum size. For details about the impact of zooming for your preferred resize strategy, see the list of available [resize strategies](/docs/topics/resize-strategies/).
+
+Note that this parameter only affects strategies that produce a still image. Animated clips generated by the \`clip\` strategy are not affected.
 `),
     strategy: z
         .object({

package/dist/v4/robots/file-read.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAyBlB,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;kBASjC,CAAA;AAEX,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGxD,CAAA;AAEJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzD,CAAA;AACD,MAAM,MAAM,uCAAuC,GAAG,4CAA4C,CAAA;AAElG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,6CAA6C,CACrD,CAAA;AAED,eAAO,MAAM,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzE,CAAA;AACD,MAAM,MAAM,uDAAuD,GAAG,CAAC,CAAC,KAAK,CAC3E,OAAO,6DAA6D,CACrE,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,6DAA6D,CACrE,CAAA"}
+{"version":3,"file":"file-read.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cAiClB,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;kBASjC,CAAA;AAEX,eAAO,MAAM,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGxD,CAAA;AAEJ,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AACvF,MAAM,MAAM,yCAAyC,GAAG,CAAC,CAAC,KAAK,CAC7D,OAAO,+CAA+C,CACvD,CAAA;AAED,eAAO,MAAM,6CAA6C;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzD,CAAA;AACD,MAAM,MAAM,uCAAuC,GAAG,4CAA4C,CAAA;AAElG,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,KAAK,CAChE,OAAO,6CAA6C,CACrD,CAAA;AAED,eAAO,MAAM,6DAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEzE,CAAA;AACD,MAAM,MAAM,uDAAuD,GAAG,CAAC,CAAC,KAAK,CAC3E,OAAO,6DAA6D,CACrE,CAAA;AACD,MAAM,MAAM,4DAA4D,GAAG,CAAC,CAAC,KAAK,CAChF,OAAO,6DAA6D,CACrE,CAAA"}

package/dist/v4/robots/file-read.js

@@ -1,10 +1,18 @@
 import { z } from 'zod/v4';
 import { interpolateRobot, robotBase, robotUse } from "./_instructions-primitives.js";
 export const meta = {
-    allowed_for_url_transform: true,
     bytescount: 5,
     discount_factor: 0.2,
     discount_pct: 80,
+    example_code: {
+        steps: {
+            read: {
+                robot: '/file/read',
+                use: ':original',
+            },
+        },
+    },
+    example_code_description: 'Read UTF-8 text content from an uploaded file:',
     minimum_charge: 512000,
     output_factor: 1,
     override_lvl1: 'Document Processing',

package/dist/v4/robots/file-serve.d.ts

@@ -27,6 +27,7 @@ export declare const robotFileServeInstructionsSchema: z.ZodObject<{
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/serve">;
+    cache_duration: z.ZodOptional<z.ZodNumber>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strict>;
 export declare const robotFileServeInstructionsWithHiddenFieldsSchema: z.ZodObject<{
@@ -54,6 +55,7 @@ export declare const robotFileServeInstructionsWithHiddenFieldsSchema: z.ZodObje
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/serve">;
+    cache_duration: z.ZodOptional<z.ZodNumber>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     result: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
 }, z.core.$strict>;
@@ -86,6 +88,7 @@ export declare const interpolatableRobotFileServeInstructionsSchema: z.ZodObject
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/serve">;
+    cache_duration: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strict>;
 export type InterpolatableRobotFileServeInstructions = InterpolatableRobotFileServeInstructionsInput;
@@ -115,6 +118,7 @@ export declare const interpolatableRobotFileServeInstructionsWithHiddenFieldsSch
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>]>>;
     robot: z.ZodLiteral<"/file/serve">;
+    cache_duration: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
 }, z.core.$strict>;

package/dist/v4/robots/file-serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-serve.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cA0BlB,CAAA;AAED,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+DlC,CAAA;AAEX,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGzD,CAAA;AAEJ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AACzF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,0CAA0C,GAAG,CAAC,CAAC,KAAK,CAC9D,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE1D,CAAA;AACD,MAAM,MAAM,wCAAwC,GAAG,6CAA6C,CAAA;AAEpG,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,8CAA8C,CACtD,CAAA;AAED,eAAO,MAAM,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE1E,CAAA;AACD,MAAM,MAAM,wDAAwD,GAAG,CAAC,CAAC,KAAK,CAC5E,OAAO,8DAA8D,CACtE,CAAA;AACD,MAAM,MAAM,6DAA6D,GAAG,CAAC,CAAC,KAAK,CACjF,OAAO,8DAA8D,CACtE,CAAA"}
+{"version":3,"file":"file-serve.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/file-serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAGnE,eAAO,MAAM,IAAI,EAAE,cA0ClB,CAAA;AAED,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA+ElC,CAAA;AAEX,eAAO,MAAM,gDAAgD;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGzD,CAAA;AAEJ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AACzF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA;AAC9F,MAAM,MAAM,0CAA0C,GAAG,CAAC,CAAC,KAAK,CAC9D,OAAO,gDAAgD,CACxD,CAAA;AAED,eAAO,MAAM,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE1D,CAAA;AACD,MAAM,MAAM,wCAAwC,GAAG,6CAA6C,CAAA;AAEpG,MAAM,MAAM,6CAA6C,GAAG,CAAC,CAAC,KAAK,CACjE,OAAO,8CAA8C,CACtD,CAAA;AAED,eAAO,MAAM,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAE1E,CAAA;AACD,MAAM,MAAM,wDAAwD,GAAG,CAAC,CAAC,KAAK,CAC5E,OAAO,8DAA8D,CACtE,CAAA;AACD,MAAM,MAAM,6DAA6D,GAAG,CAAC,CAAC,KAAK,CACjF,OAAO,8DAA8D,CACtE,CAAA"}