@transloadit/node 4.7.6 → 4.7.7

package/src/alphalib/types/robots/audio-waveform.ts

@@ -10,7 +10,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
@@ -52,7 +51,7 @@ Here is an example waveform image:
   priceFactor: 1,
   queueSlotCount: 20,
   minimumCharge: 1048576,
-  isAllowedForUrlTransform: false,
+  isAllowedForUrlTransform: true,
   trackOutputFileSize: true,
   isInternal: false,
   removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
@@ -74,6 +73,7 @@ Similarly, if you need the output image in a different format, please pipe the r
       .default('image')
       .describe(`
 The format of the result file. Can be \`"image"\` or \`"json"\`. If \`"image"\` is supplied, a PNG image will be created, otherwise a JSON file.
+When \`style\` is \`"spectrogram"\`, only \`"image"\` is supported.
 `),
     width: z
       .number()
@@ -110,15 +110,50 @@ The color used in the outer parts of the gradient. The format is "rrggbbaa" (red
 
 const styleSchema = z.preprocess(
   (val) => {
-    // Backwards compatibility: historically this robot used numeric styles 0/1/2.
-    // The new API is `style: "v0" | "v1"`. Old v2 values are mapped to v1.
+    // Backwards compatibility: historically this robot used numeric styles 0/1.
+    // The new API is `style: "v0" | "v1" | "spectrogram"`.
     if (val === 'v1' || val === 1 || val === '1') return 'v1'
     if (val === 'v0' || val === 0 || val === '0') return 'v0'
+    if (val === 'spectrogram') return 'spectrogram'
     return val
   },
-  z.enum(['v0', 'v1']).default('v0'),
+  z.enum(['v0', 'v1', 'spectrogram']).default('v0'),
 )
 
+// Color maps for spectrogram visualization
+export type SpectrogramColorMap =
+  | 'viridis'
+  | 'plasma'
+  | 'magma'
+  | 'cividis'
+  | 'cool'
+  | 'rainbow'
+  | 'moreland'
+  | 'nebulae'
+  | 'fire'
+  | 'fiery'
+  | 'fruit'
+  | 'green'
+  | 'terrain'
+  | 'gray'
+
+export const spectrogramColorMaps = [
+  'viridis',
+  'plasma',
+  'magma',
+  'cividis',
+  'cool',
+  'rainbow',
+  'moreland',
+  'nebulae',
+  'fire',
+  'fiery',
+  'fruit',
+  'green',
+  'terrain',
+  'gray',
+] as const satisfies readonly SpectrogramColorMap[]
+
 // Unified schema: all parameters exist for both styles, but v1-only parameters only apply when
 // `style` is `v1` (they are accepted for v0 but have no effect).
 export const robotAudioWaveformInstructionsSchema = robotAudioWaveformInstructionsBaseSchema
@@ -128,8 +163,9 @@ Waveform style version.
 
 - \`"v0"\`: Legacy waveform generation (default).
 - \`"v1"\`: Advanced waveform generation with additional parameters.
+- \`"spectrogram"\`: Spectrogram visualization showing frequency content over time.
 
-For backwards compatibility, numeric values \`0\`, \`1\`, \`2\` are also accepted and mapped to \`"v0"\` (0) and \`"v1"\` (1/2).
+For backwards compatibility, numeric values \`0\` and \`1\` are also accepted and mapped to \`"v0"\` and \`"v1"\`.
 `),
 
     // v1-only parameters (accepted for v0 but have no effect)
@@ -241,6 +277,54 @@ Available when style is \`"v1"\`. Amplitude scale factor.
       .optional()
       .describe(`
 Available when style is \`"v1"\`. PNG compression level: 0 (none) to 9 (best), or -1 (default). Only applicable when format is "image".
+`),
+
+    // Spectrogram-specific parameters (only apply when style is "spectrogram")
+    color_map: z
+      .enum(spectrogramColorMaps)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Color scheme for the spectrogram visualization. Defaults to \`"viridis"\`.
+`),
+    frequency_scale: z
+      .enum(['linear', 'logarithmic'])
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Frequency scale for the spectrogram. \`"linear"\` shows frequencies evenly spaced, \`"logarithmic"\` emphasizes lower frequencies. Defaults to \`"logarithmic"\`.
+`),
+    frequency_min: z
+      .number()
+      .min(0)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Minimum frequency in Hz to display. Defaults to \`0\`.
+`),
+    frequency_max: z
+      .number()
+      .min(1)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Maximum frequency in Hz to display. Defaults to half the sample rate (Nyquist frequency).
+`),
+    legend: z
+      .boolean()
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Whether to include a legend showing the frequency and time scales. Defaults to \`false\`.
+`),
+    gain: z
+      .number()
+      .min(0)
+      .max(128)
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Linear gain factor for spectrogram intensity. Defaults to \`1\`.
+`),
+    orientation: z
+      .enum(['vertical', 'horizontal'])
+      .optional()
+      .describe(`
+Available when style is \`"spectrogram"\`. Orientation of the spectrogram. \`"horizontal"\` shows time on the x-axis (default), \`"vertical"\` shows time on the y-axis.
 `),
   })
   .strict()

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

@@ -13,7 +13,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/azure-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { azureBase, 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/backblaze-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/backblaze-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { backblazeBase, 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/box-import.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  boxBase,
+  interpolateRobot,
+  path,
+  robotBase,
+  robotImport,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 10,
+  discount_factor: 0.1,
+  discount_pct: 90,
+  example_code: {
+    steps: {
+      imported: {
+        robot: '/box/import',
+        credentials: 'YOUR_BOX_CREDENTIALS',
+        path: 'path/to/files/',
+      },
+    },
+  },
+  example_code_description:
+    'Import files from the `path/to/files` directory and its subdirectories:',
+  has_small_icon: true,
+  minimum_charge: 0,
+  output_factor: 1,
+  override_lvl1: 'File Importing',
+  purpose_sentence: 'imports whole directories of files from your Box',
+  purpose_verb: 'import',
+  purpose_word: 'Box',
+  purpose_words: 'Import files from Box',
+  requires_credentials: true,
+  service_slug: 'file-importing',
+  slot_count: 20,
+  title: 'Import files from Box',
+  typical_file_size_mb: 1.2,
+  typical_file_type: 'file',
+  name: 'BoxImportRobot',
+  priceFactor: 6.6666,
+  queueSlotCount: 20,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: false,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: true,
+  stage: 'ga',
+}
+
+export const robotBoxImportInstructionsSchema = robotBase
+  .merge(robotImport)
+  .merge(boxBase)
+  .extend({
+    robot: z.literal('/box/import'),
+    path: path.describe(`
+The path in your Box to the specific file or directory. If the path points to a file, only this file will be imported. For example: \`images/avatar.jpg\`.
+
+If it points to a directory, indicated by a trailing slash (\`/\`), then all files that are descendants of this directory are recursively imported. For example: \`images/\`.
+
+If you want to import all files from the root directory, please use \`/\` as the value here.
+
+You can also use an array of path strings here to import multiple paths in the same <dfn>Robot</dfn>'s <dfn>Step</dfn>.
+`),
+  })
+  .strict()
+
+export const robotBoxImportInstructionsWithHiddenFieldsSchema =
+  robotBoxImportInstructionsSchema.extend({
+    result: z.union([z.literal('debug'), robotBoxImportInstructionsSchema.shape.result]).optional(),
+    access_token: z.string().optional(),
+    key_file_contents: z.string().optional(),
+  })
+
+export type RobotBoxImportInstructions = z.infer<typeof robotBoxImportInstructionsSchema>
+export type RobotBoxImportInstructionsWithHiddenFields = z.infer<
+  typeof robotBoxImportInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotBoxImportInstructionsSchema = interpolateRobot(
+  robotBoxImportInstructionsSchema,
+)
+export type InterpolatableRobotBoxImportInstructions = InterpolatableRobotBoxImportInstructionsInput
+
+export type InterpolatableRobotBoxImportInstructionsInput = z.input<
+  typeof interpolatableRobotBoxImportInstructionsSchema
+>
+
+export const interpolatableRobotBoxImportInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotBoxImportInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotBoxImportInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotBoxImportInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotBoxImportInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotBoxImportInstructionsWithHiddenFieldsSchema
+>

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()