transloadit 4.7.6 → 4.8.0

package/src/alphalib/types/robots/box-store.ts

@@ -0,0 +1,94 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { boxBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 6,
+  discount_factor: 0.15000150001500018,
+  discount_pct: 84.99984999849998,
+  example_code: {
+    steps: {
+      exported: {
+        robot: '/box/store',
+        use: ':original',
+        credentials: 'YOUR_BOX_CREDENTIALS',
+        path: 'my_target_folder/${unique_prefix}/${file.url_name}',
+      },
+    },
+  },
+  example_code_description: 'Export uploaded files to `my_target_folder` on Box:',
+  has_small_icon: true,
+  minimum_charge: 0,
+  output_factor: 1,
+  override_lvl1: 'File Exporting',
+  purpose_sentence: 'exports encoding results to Box',
+  purpose_verb: 'export',
+  purpose_word: 'Box',
+  purpose_words: 'Export files to Box',
+  service_slug: 'file-exporting',
+  slot_count: 10,
+  title: 'Export files to Box',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'BoxStoreRobot',
+  priceFactor: 6.6666,
+  queueSlotCount: 10,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotBoxStoreInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(boxBase)
+  .extend({
+    robot: z.literal('/box/store'),
+    path: z
+      .string()
+      .default('${unique_prefix}/${file.url_name}')
+      .describe(`
+The path at which the file is to be stored. This may include any available [Assembly variables](/docs/topics/assembly-instructions/#assembly-variables).
+`),
+    create_sharing_link: z
+      .boolean()
+      .default(false)
+      .describe(`
+Whether to create a URL to this file for sharing with other people. This will overwrite the file's \`"url"\` property.
+`),
+  })
+  .strict()
+
+export const robotBoxStoreInstructionsWithHiddenFieldsSchema =
+  robotBoxStoreInstructionsSchema.extend({
+    result: z.union([z.literal('debug'), robotBoxStoreInstructionsSchema.shape.result]).optional(),
+    access_token: z.string().optional(),
+    key_file_contents: z.string().optional(),
+  })
+
+export type RobotBoxStoreInstructions = z.infer<typeof robotBoxStoreInstructionsSchema>
+export type RobotBoxStoreInstructionsInput = z.input<typeof robotBoxStoreInstructionsSchema>
+export type RobotBoxStoreInstructionsWithHiddenFields = z.infer<
+  typeof robotBoxStoreInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotBoxStoreInstructionsSchema = interpolateRobot(
+  robotBoxStoreInstructionsSchema,
+)
+export type InterpolatableRobotBoxStoreInstructions = InterpolatableRobotBoxStoreInstructionsInput
+
+export type InterpolatableRobotBoxStoreInstructionsInput = z.input<
+  typeof interpolatableRobotBoxStoreInstructionsSchema
+>
+
+export const interpolatableRobotBoxStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotBoxStoreInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotBoxStoreInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotBoxStoreInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotBoxStoreInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotBoxStoreInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/cloudfiles-import.ts

@@ -12,7 +12,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,

package/src/alphalib/types/robots/cloudfiles-store.ts

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,

package/src/alphalib/types/robots/cloudflare-import.ts

@@ -14,7 +14,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,

package/src/alphalib/types/robots/cloudflare-store.ts

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,

package/src/alphalib/types/robots/digitalocean-import.ts

@@ -14,7 +14,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,

package/src/alphalib/types/robots/digitalocean-store.ts

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,

package/src/alphalib/types/robots/document-autorotate.ts

@@ -4,10 +4,17 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
+  example_code: {
+    steps: {
+      rotated: {
+        robot: '/document/autorotate',
+        use: ':original',
+      },
+    },
+  },
   example_code_description:
     'Auto-rotate individual pages of a documents to the correction orientation:',
   minimum_charge: 2097152,

package/src/alphalib/types/robots/document-convert.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -54,9 +53,11 @@ The following file formats can be converted from:
 - \`ps\`
 - \`rtf\`
 - \`rtx\`
+- \`srt\`
 - \`svg\`
 - \`text\`
 - \`txt\`
+- \`vtt\`
 - \`xhtml\`
 - \`xla\`
 - \`xls\`
@@ -84,7 +85,10 @@ The following file formats can be converted from:
   queueSlotCount: 32,
   minimumCharge: 1048576,
   lazyLoad: true,
-  installVersionFile: process.env.API2_UNOCONV_INSTALL_VERSION_FILE || '',
+  installVersionFile:
+    typeof process !== 'undefined' && process.env.API2_UNOCONV_INSTALL_VERSION_FILE
+      ? process.env.API2_UNOCONV_INSTALL_VERSION_FILE
+      : '',
   isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   // we cannot use coreConfig.numUnoconvDaemons, because it does not live in alphalib
@@ -106,7 +110,7 @@ Sometimes, a certain file type might not support what you are trying to accompli
 Using this Robot, you can bypass the issues that certain file types may bring, by converting your file into the most suitable format. This also works in conjunction with our other Robots, allowing for even greater versatility when using our services.
 
 > [!Warning]
-> A general rule of this Robot is that converting files into an alien format category will result in an error. For example, SRT files can be converted into the VTT format, but not to an image.
+> A general rule of this Robot is that converting files into an alien format category will result in an error. For example, SRT files can be converted into the VTT format (and vice versa), but not to an image.
 
 The following file formats can be converted from:
 
@@ -133,9 +137,11 @@ The following file formats can be converted from:
 - \`ps\`
 - \`rtf\`
 - \`rtx\`
+- \`srt\`
 - \`svg\`
 - \`text\`
 - \`txt\`
+- \`vtt\`
 - \`xhtml\`
 - \`xla\`
 - \`xls\`
@@ -154,6 +160,7 @@ The following file formats can be converted from:
         'jpeg',
         'jpg',
         'latex',
+        'md',
         'oda',
         'odd',
         'odt',

package/src/alphalib/types/robots/document-merge.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,

package/src/alphalib/types/robots/document-ocr.ts

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,

package/src/alphalib/types/robots/document-optimize.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,

package/src/alphalib/types/robots/document-split.ts

@@ -4,10 +4,18 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
+  example_code: {
+    steps: {
+      extracted_pages: {
+        robot: '/document/split',
+        use: ':original',
+        pages: ['1', '3-5'],
+      },
+    },
+  },
   example_code_description: 'Extract single or multiple pages from a PDF document:',
   minimum_charge: 2097152,
   output_factor: 1,

package/src/alphalib/types/robots/document-thumbs.ts

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -68,6 +67,23 @@ export const robotDocumentThumbsInstructionsSchema = robotBase
       .default(null)
       .describe(`
 The PDF page that you want to convert to an image. By default the value is \`null\` which means that all pages will be converted into images.
+`),
+    page_range: z
+      .string()
+      .regex(/^\d+-\d+$/)
+      .refine(
+        (val) => {
+          const [start, end] = val.split('-').map(Number)
+          return start >= 1 && end >= start
+        },
+        { message: 'Start must be ≥ 1 and end must be ≥ start (e.g. "1-20")' },
+      )
+      .nullable()
+      .default(null)
+      .describe(`
+A page range to extract, in the format \`"start-end"\` (e.g., \`"1-20"\`). Extraction starts from the first page in the range and proceeds sequentially, stopping gracefully when a page does not exist. This is useful for PDFs where the total page count cannot be determined.
+
+This parameter cannot be used together with \`page\`, and is not supported with GIF format. When \`page_range\` is set, the robot does not need to know the total page count upfront, making it robust for PDFs that fail page count detection.
 `),
     format: z
       .enum(['gif', 'jpeg', 'jpg', 'png'])
@@ -169,11 +185,17 @@ Some PDF documents lie about their dimensions. For instance they'll say they are
       .boolean()
       .default(true)
       .describe(`
-If you set this to \`false\`, the robot will not emit files as they become available. This is useful if you are only interested in the final result and not in the intermediate steps.
+Enables high-performance mode for faster document processing.
+
+When enabled, Turbo Mode provides two key optimizations:
+
+1. **Parallel page extraction**: For documents with more than 5 pages, multiple processes run in parallel to extract pages simultaneously. The number of parallel processes scales with the document size (up to 4 processes for documents with 13+ pages).
+
+2. **Distributed resizing**: Extracted pages are resized concurrently on multiple machines, providing up to 20 times faster processing for large documents.
 
-Also, extracted pages will be resized a lot faster as they are sent off to other machines for the resizing. This is especially useful for large documents with many pages to get up to 20 times faster processing.
+Files are emitted as they become available during processing. If you set this to \`false\`, pages are extracted sequentially using a single process, and files are emitted only after all processing is complete.
 
-Turbo Mode increases pricing, though, in that the input document's file size is added for every extracted page. There are no performance benefits nor increased charges for single-page documents.
+Turbo Mode increases pricing in that the input document's file size is added for every extracted page. There are no performance benefits nor increased charges for single-page documents.
 `),
   })
   .strict()

package/src/alphalib/types/robots/dropbox-import.ts

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 10,
   discount_factor: 0.1,
   discount_pct: 90,

package/src/alphalib/types/robots/dropbox-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { dropboxBase, interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,

package/src/alphalib/types/robots/edgly-deliver.ts

@@ -3,10 +3,17 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  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/src/alphalib/types/robots/file-compress.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -130,6 +129,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/src/alphalib/types/robots/file-decompress.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 0.8,
   discount_pct: 20,
@@ -46,9 +45,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
@@ -74,7 +73,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']))])
@@ -88,6 +101,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/src/alphalib/types/robots/file-filter.ts

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 0,
   discount_factor: 0,
   discount_pct: 100,
@@ -18,7 +17,7 @@ export const meta: RobotMetaInput = {
       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',
       },
@@ -74,9 +73,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]
@@ -98,9 +109,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.
 
@@ -111,9 +125,12 @@ If \`accepts\` and \`declines\` are both provided, the requirements in \`accepts
     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/src/alphalib/types/robots/file-hash.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 5,
   discount_factor: 0.2,
   discount_pct: 80,
@@ -52,6 +51,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/src/alphalib/types/robots/file-preview.ts

@@ -13,7 +13,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -83,6 +82,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/src/alphalib/types/robots/file-read.ts

@@ -4,10 +4,18 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  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',