@transloadit/node 4.7.6 → 4.7.7

package/src/alphalib/types/robots/video-generate.ts

@@ -0,0 +1,120 @@
+import { z } from 'zod'
+
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import { interpolateRobot, robotBase, robotUse } from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      generated_video: {
+        robot: '/video/generate',
+        prompt: 'A slow cinematic drone shot of ocean cliffs at sunrise, realistic lighting.',
+        duration: 5,
+        aspect_ratio: '16:9',
+        format: 'mp4',
+      },
+    },
+  },
+  example_code_description: 'Generate a short video from a text prompt:',
+  minimum_charge: 0,
+  output_factor: 0.6,
+  purpose_sentence: 'generates videos from text prompts using AI',
+  purpose_verb: 'generate',
+  purpose_word: 'generate',
+  purpose_words: 'Generate videos from text prompts',
+  service_slug: 'artificial-intelligence',
+  slot_count: 10,
+  title: 'Generate videos from text prompts',
+  typical_file_size_mb: 50,
+  typical_file_type: 'video',
+  name: 'VideoGenerateRobot',
+  priceFactor: 1,
+  queueSlotCount: 10,
+  minimumChargeUsd: 0.06,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+export const robotVideoGenerateInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/video/generate'),
+    model: z
+      .string()
+      .optional()
+      .describe('The AI model to use for video generation. Defaults to minimax/video-01.'),
+    prompt: z.string().describe('The prompt describing the desired video content.'),
+    format: z.enum(['mp4', 'gif']).optional().describe('Format of the generated video.'),
+    seed: z.number().optional().describe('Seed for the random number generator.'),
+    aspect_ratio: z.string().optional().describe('Aspect ratio of the generated video.'),
+    height: z.number().optional().describe('Height of the generated video.'),
+    width: z.number().optional().describe('Width of the generated video.'),
+    style: z.string().optional().describe('Style of the generated video.'),
+    num_outputs: z
+      .number()
+      .int()
+      .min(1)
+      .max(10)
+      .optional()
+      .describe('Number of video variants to generate.'),
+    duration: z.number().optional().describe('Duration of the generated video in seconds.'),
+    fps: z.number().optional().describe('Frames per second of the output video.'),
+    motion_amount: z
+      .number()
+      .optional()
+      .describe('Controls the intensity of motion in the generated video.'),
+    camera_motion: z
+      .string()
+      .optional()
+      .describe(
+        'Camera movement type (e.g., pan-left, pan-right, zoom-in, zoom-out, orbit, static, dolly, crane).',
+      ),
+    negative_prompt: z
+      .string()
+      .optional()
+      .describe('Describes what should be avoided in the generated video.'),
+    reference_strength: z
+      .number()
+      .optional()
+      .describe('How closely the output should follow the reference input (0.0 - 1.0).'),
+  })
+  .strict()
+
+export const robotVideoGenerateInstructionsWithHiddenFieldsSchema =
+  robotVideoGenerateInstructionsSchema.extend({
+    provider: z.string().optional().describe('Provider for generating the video.'),
+    result: z
+      .union([z.literal('debug'), robotVideoGenerateInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotVideoGenerateInstructions = z.infer<typeof robotVideoGenerateInstructionsSchema>
+export type RobotVideoGenerateInstructionsWithHiddenFields = z.infer<
+  typeof robotVideoGenerateInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotVideoGenerateInstructionsSchema = interpolateRobot(
+  robotVideoGenerateInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotVideoGenerateInstructions =
+  InterpolatableRobotVideoGenerateInstructionsInput
+
+export type InterpolatableRobotVideoGenerateInstructionsInput = z.input<
+  typeof interpolatableRobotVideoGenerateInstructionsSchema
+>
+
+export const interpolatableRobotVideoGenerateInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotVideoGenerateInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotVideoGenerateInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotVideoGenerateInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotVideoGenerateInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotVideoGenerateInstructionsWithHiddenFieldsSchema
+>

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

@@ -11,10 +11,26 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
+  example_code: {
+    steps: {
+      merged: {
+        robot: '/video/merge',
+        use: [
+          { name: ':original', as: 'image' },
+          { name: ':original', as: 'audio' },
+        ],
+        width: 1280,
+        height: 720,
+        resize_strategy: 'pad',
+        framerate: '1/4',
+        duration: 12,
+      },
+    },
+  },
+  example_code_description: 'Merge uploaded image and audio inputs into one video:',
   minimum_charge: 0,
   output_factor: 0.6,
   override_lvl1: 'Video Encoding',
@@ -101,6 +117,22 @@ Stacks the input media vertically. All streams need to have the same pixel forma
       .optional()
       .describe(`
 The URL of an image to be merged with the audio or video. When this parameter is provided, the robot will download the image from the URL and merge it with the other media.
+`),
+    transition: z
+      .enum(['none', 'crossfade', 'fade_to_black'])
+      .default('none')
+      .describe(`
+The type of transition effect to apply between concatenated video clips. Only applies when concatenating multiple videos (using \`video_1\`, \`video_2\`, etc. or \`pre_roll\`/\`post_roll\` inputs).
+
+- \`"none"\` — No transition effect. Videos are joined end-to-end.
+- \`"crossfade"\` — A gradual blend from one clip to the next (both video and audio).
+- \`"fade_to_black"\` — The current clip fades out to black, then the next clip fades in from black.
+`),
+    transition_duration: z
+      .number()
+      .default(1)
+      .describe(`
+The duration of the transition effect in seconds. Only applies when \`transition\` is not \`"none"\`. Supports float values (e.g., \`0.5\` for a 500ms transition) and must be greater than \`0\` whenever transitions are enabled. The applied transition is automatically capped at half of the shorter clip in each transition pair to prevent overlapping transitions.
 `),
   })
   .strict()

package/src/alphalib/types/robots/video-ondemand.ts

@@ -9,7 +9,6 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   discount_factor: 1,
   discount_pct: 0,
   bytescount: 1,
@@ -84,7 +83,7 @@ export const robotVideoOndemandInstructionsSchema = robotBase
       .union([z.string(), z.array(z.string())])
       .optional()
       .describe(
-        'Specifies which variants, defined in the variants parameter, are enabled. Non-enabled variants will not be included in the master playlist.',
+        'Specifies which variants, defined in the variants parameter, are enabled. Non-enabled variants will not be included in the multivariant playlist.',
       ),
     segment_duration: z
       .number()
@@ -96,13 +95,13 @@ export const robotVideoOndemandInstructionsSchema = robotBase
       .optional()
       .default(0)
       .describe(
-        'When signing URLs is enabled, the URLs in the generated playlist files will be signed. This parameter specifies the duration (in seconds) that the signed URLs will remain valid.',
+        'When signing URLs is enabled, the URLs in the generated playlist files will be signed. This parameter specifies the duration (in seconds) that the signed URLs will remain valid. Use the modern `sig` + `exp` format for new integrations. Legacy `s` signatures are deprecated. Shorter expirations reduce the replay window, but they also reduce cache reuse and can increase segment re-generation and latency.',
       ),
     asset: z
       .string()
       .optional()
       .describe(
-        'Controls which file is generated. For example, if the parameter is unset, a master playlist referencing the variants is generated.',
+        'Controls which file is generated. For example, if the parameter is unset, a multivariant playlist referencing the variants is generated.',
       ),
     asset_param_name: z
       .string()

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

@@ -0,0 +1,117 @@
+import { z } from 'zod'
+
+import { stackVersions } from '../stackVersions.ts'
+import type { RobotMetaInput } from './_instructions-primitives.ts'
+import {
+  interpolateRobot,
+  robotBase,
+  robotFFmpegVideo,
+  robotUse,
+} from './_instructions-primitives.ts'
+
+export const meta: RobotMetaInput = {
+  bytescount: 1,
+  discount_factor: 1,
+  discount_pct: 0,
+  example_code: {
+    steps: {
+      split: {
+        robot: '/video/split',
+        use: ':original',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+        segments: [
+          { from: 0, to: 30 },
+          { from: 60, to: 90 },
+        ],
+      },
+    },
+  },
+  example_code_description:
+    'Split a video into two segments, extracting the first 30 seconds and a segment from 1:00 to 1:30:',
+  minimum_charge: 0,
+  output_factor: 0.6,
+  override_lvl1: 'Video Encoding',
+  purpose_sentence: 'splits a video into multiple segments based on an array of from/to durations',
+  purpose_verb: 'split',
+  purpose_word: 'split',
+  purpose_words: 'Split video',
+  service_slug: 'video-encoding',
+  slot_count: 60,
+  title: 'Split video',
+  typical_file_size_mb: 80,
+  typical_file_type: 'video',
+  uses_tools: ['ffmpeg'],
+  name: 'VideoSplitRobot',
+  priceFactor: 1,
+  queueSlotCount: 60,
+  isAllowedForUrlTransform: false,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'ga',
+}
+
+const segmentSchema = z
+  .object({
+    from: z
+      .union([z.number(), z.string()])
+      .describe(
+        'Start time of the segment in seconds (e.g. `30`) or as a timecode string (e.g. `"00:00:30.000"`).',
+      ),
+    to: z
+      .union([z.number(), z.string()])
+      .describe(
+        'End time of the segment in seconds (e.g. `60`) or as a timecode string (e.g. `"00:01:00.000"`).',
+      ),
+  })
+  .strict()
+
+export const robotVideoSplitInstructionsSchema = robotBase
+  .merge(robotUse)
+  .merge(robotFFmpegVideo)
+  .extend({
+    robot: z.literal('/video/split').describe(`
+Splits a video into multiple segments based on an array of from/to durations. Each segment produces a separate output file. This is useful for cutting a video into parts, for example to insert ads later via [🤖/video/concat](/docs/robots/video-concat/).
+`),
+    segments: z
+      .array(segmentSchema)
+      .min(1)
+      .describe(`
+An array of objects, each specifying a segment to extract from the input video. Each object must have a \`from\` and \`to\` key indicating the start and end time of the segment.
+
+Times can be specified as numbers (seconds) or as timecode strings (e.g. \`"00:01:30.000"\`).
+`),
+  })
+  .strict()
+
+export const robotVideoSplitInstructionsWithHiddenFieldsSchema =
+  robotVideoSplitInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotVideoSplitInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotVideoSplitInstructions = z.infer<typeof robotVideoSplitInstructionsSchema>
+export type RobotVideoSplitInstructionsWithHiddenFields = z.infer<
+  typeof robotVideoSplitInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotVideoSplitInstructionsSchema = interpolateRobot(
+  robotVideoSplitInstructionsSchema,
+)
+export type InterpolatableRobotVideoSplitInstructions =
+  InterpolatableRobotVideoSplitInstructionsInput
+
+export type InterpolatableRobotVideoSplitInstructionsInput = z.input<
+  typeof interpolatableRobotVideoSplitInstructionsSchema
+>
+
+export const interpolatableRobotVideoSplitInstructionsWithHiddenFieldsSchema = interpolateRobot(
+  robotVideoSplitInstructionsWithHiddenFieldsSchema,
+)
+export type InterpolatableRobotVideoSplitInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotVideoSplitInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotVideoSplitInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotVideoSplitInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/types/robots/video-subtitle.ts

@@ -13,13 +13,12 @@ import {
 } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: false,
   bytescount: 1,
   discount_factor: 1,
   discount_pct: 0,
   example_code: {
     steps: {
-      subtitled: {
+      add_english_subtitles: {
         robot: '/video/subtitle',
         use: {
           steps: [
@@ -30,17 +29,39 @@ export const meta: RobotMetaInput = {
             },
             {
               name: ':original',
-              fields: 'input_srt',
+              fields: 'input_srt_en',
               as: 'subtitles',
             },
           ],
         },
+        language: 'eng',
+        name: 'English',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
+      },
+      add_german_subtitles: {
+        robot: '/video/subtitle',
+        use: {
+          steps: [
+            {
+              name: 'add_english_subtitles',
+              as: 'video',
+            },
+            {
+              name: ':original',
+              fields: 'input_srt_de',
+              as: 'subtitles',
+            },
+          ],
+        },
+        language: 'deu',
+        name: 'Deutsch',
+        keep_subtitles: true,
         ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
       },
     },
   },
   example_code_description:
-    'If you have two file input fields in a form — one for a video and another for an SRT or VTT subtitle, named `input_video` and `input_srt` respectively (with the HTML `name` attribute), hereʼs how to embed the subtitles into the video with Transloadit:',
+    'If you have file input fields in a form — one for a video and one for each subtitle language (named `input_video`, `input_srt_en`, and `input_srt_de` via the HTML `name` attribute) — hereʼs how to add multiple subtitle streams with language tags to the video. Chain multiple `/video/subtitle` Steps with `keep_subtitles` set to `true` so each new stream is added alongside existing ones:',
   minimum_charge: 0,
   output_factor: 0.6,
   override_lvl1: 'Video Encoding',
@@ -96,8 +117,11 @@ The font family to use. Also includes boldness and style of the font.
 
 [Here](/docs/supported-formats/fonts/) is a list of all supported fonts.
 `),
-    font_color: color_without_alpha.default('FFFFFF').describe(`
-The color of the subtitle text. The first two hex digits specify the alpha value of the color.
+    font_color: z
+      .union([color_without_alpha, color_with_alpha])
+      .default('FFFFFF')
+      .describe(`
+The color of the subtitle text in \`"rgb"\`, \`"rrggbb"\`, or \`"aarrggbb"\` format. If 8 hex digits are provided, the first two specify the alpha value of the color (\`"00"\` is fully opaque, \`"ff"\` is fully transparent).
 `),
     font_size: z
       .number()
@@ -106,6 +130,28 @@ The color of the subtitle text. The first two hex digits specify the alpha value
       .default(16)
       .describe(`
 Specifies the size of the text.
+`),
+    bold: z
+      .boolean()
+      .default(false)
+      .describe(`
+Specifies whether the subtitle text should be bold. Only applies to burned subtitles.
+`),
+    italic: z
+      .boolean()
+      .default(false)
+      .describe(`
+Specifies whether the subtitle text should be italic. Only applies to burned subtitles.
+`),
+    outline_width: z
+      .number()
+      .int()
+      .min(0)
+      .max(10)
+      .optional()
+      .nullable()
+      .describe(`
+Specifies the width of the text outline in pixels. Only applies to burned subtitles with \`"outline"\` or \`"box"\` border styles. If not specified, the default width is used.
 `),
     position: positionSchema.default('bottom').describe(`
 Specifies the position of the subtitles.
@@ -115,13 +161,20 @@ Specifies the position of the subtitles.
       .optional()
       .nullable()
       .describe(`
-Specifies the language of the subtitles. Only used if the subtitles are external.
+Specifies the language of the subtitle stream using a three-letter language code (e.g. \`"eng"\`, \`"deu"\`, \`"spa"\`). Only used if the subtitles are external. When adding multiple subtitle streams, set a different language for each stream so that video players can offer language selection.
+`),
+    name: z
+      .string()
+      .optional()
+      .nullable()
+      .describe(`
+Specifies a human-readable name for the subtitle track (e.g. \`"English"\`, \`"Deutsch"\`, \`"Español"\`). Only used if the subtitles are external. This name is displayed in video player subtitle menus alongside the language.
 `),
     keep_subtitles: z
       .boolean()
       .default(false)
       .describe(`
-Specifies if existing subtitles in the input file should be kept or be replaced by the new subtitle. Only used if the subtitles are external.
+Specifies if existing subtitles in the input file should be kept or be replaced by the new subtitle. Only used if the subtitles are external. Set this to \`true\` when chaining multiple \`/video/subtitle\` Steps to add several subtitle streams (e.g. different languages) to the same video.
 `),
   })
   .strict()

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

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

package/src/alphalib/types/robots/vimeo-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/vimeo-store.ts

@@ -4,10 +4,10 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, vimeoBase } from './_instructions-primitives.ts'
 
 export const meta: RobotMetaInput = {
-  allowed_for_url_transform: true,
   bytescount: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,
+  hideCredentialsWarning: true,
   example_code: {
     steps: {
       exported: {
@@ -24,7 +24,7 @@ export const meta: RobotMetaInput = {
   minimum_charge: 0,
   output_factor: 1,
   override_lvl1: 'File Exporting',
-  purpose_sentence: 'exports encoding results to vimeo',
+  purpose_sentence: 'exports encoding results to Vimeo',
   purpose_verb: 'export',
   purpose_word: 'Vimeo',
   purpose_words: 'Export files to Vimeo',
@@ -47,7 +47,18 @@ export const robotVimeoStoreInstructionsSchema = robotBase
   .merge(robotUse)
   .merge(vimeoBase)
   .extend({
-    robot: z.literal('/vimeo/store'),
+    robot: z.literal('/vimeo/store').describe(`
+## Getting started
+
+Since Vimeo works with OAuth, you will need to generate [Template Credentials](https://transloadit.com/c/template-credentials/) to use this <dfn>Robot</dfn>.
+
+To change the \`title\` or \`description\` per video, we recommend to [inject variables into your Template](/docs/topics/templates/).
+
+> [!Warning]
+> Vimeo's API limits the number of concurrent uploads per minute based on your Vimeo account plan. To see how many videos can be uploaded at once based on your plan, click the following [link](https://developer.vimeo.com/guidelines/rate-limiting#table-1).
+
+Note that this <dfn>Robot</dfn> only accepts videos.
+`),
     title: z.string().describe(`
 The title of the video to be displayed on Vimeo.
 `),

package/src/alphalib/types/robots/wasabi-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/wasabi-store.ts

@@ -4,7 +4,6 @@ import type { RobotMetaInput } from './_instructions-primitives.ts'
 import { interpolateRobot, robotBase, robotUse, wasabiBase } 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/youtube-store.ts

@@ -4,10 +4,10 @@ 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: 6,
   discount_factor: 0.15000150001500018,
   discount_pct: 84.99984999849998,
+  hideCredentialsWarning: true,
   example_code: {
     steps: {
       exported: {
@@ -49,15 +49,14 @@ export const robotYoutubeStoreInstructionsSchema = robotBase
   .merge(robotUse)
   .extend({
     robot: z.literal('/youtube/store').describe(`
-> [!Note]
-> This <dfn>Robot</dfn> only accepts videos.
-
-## Installation
+## Getting started
 
 Since YouTube works with OAuth, you will need to generate [Template Credentials](/c/template-credentials/) to use this <dfn>Robot</dfn>.
 
 To change the \`title\`, \`description\`, \`category\`, or \`keywords\` per video, we recommend to [inject variables into your Template](/docs/topics/templates/).
 
+Note that this <dfn>Robot</dfn> only accepts videos.
+
 ## Adding a thumbnail image to your video
 
 You can add a custom thumbnail to your video on YouTube by using our \`"as"\` syntax for the \`"use"\` parameter to supply both a video and an image to the step:

package/src/alphalib/types/template.ts

@@ -1,9 +1,22 @@
 import { z } from 'zod'
 
-import { robotsSchema, robotsWithHiddenBotsAndFieldsSchema } from './robots/_index.ts'
+import {
+  robotsSchema,
+  robotsWithHiddenBotsAndFieldsSchema,
+} from './robots/_index.ts'
+import type {
+  RobotsSchema,
+  RobotsWithHiddenBotsAndFields,
+} from './robots/_index.ts'
 import type { RobotUse } from './robots/_instructions-primitives.ts'
 
-export const stepSchema = z
+export type Step = RobotsSchema
+export type StepInput = Step
+export type StepInputWithUse = StepInput & RobotUse
+export type Steps = Record<string, Step>
+export type StepsInput = Steps
+
+export const stepSchema: z.ZodType<Step> = z
   .object({
     // This is a hack to get nicer robot hover messages in editors.
     robot: z
@@ -11,15 +24,17 @@ export const stepSchema = z
       .describe('Identifier of the [robot](https://transloadit.com/docs/robots/) to execute'),
   })
   .and(robotsSchema)
-export const stepsSchema = z.record(stepSchema).describe('Contains Assembly Instructions.')
-export type Step = z.infer<typeof stepSchema>
-export type StepInput = z.input<typeof stepSchema>
-export type StepInputWithUse = StepInput & RobotUse
-export type Steps = z.infer<typeof stepsSchema>
-export type StepsInput = z.input<typeof stepsSchema>
+export const stepsSchema: z.ZodType<Steps> = z
+  .record(stepSchema)
+  .describe('Contains Assembly Instructions.')
 export const optionalStepsSchema = stepsSchema.optional()
 
-export const stepSchemaWithHiddenFields = z
+export type StepWithHiddenFields = RobotsWithHiddenBotsAndFields
+export type StepWithHiddenFieldsInput = StepWithHiddenFields
+export type StepsWithHiddenFields = Record<string, StepWithHiddenFields>
+export type StepsWithHiddenFieldsInput = StepsWithHiddenFields
+
+export const stepSchemaWithHiddenFields: z.ZodType<StepWithHiddenFields> = z
   .object({
     // This is a hack to get nicer robot hover messages in editors.
     robot: z
@@ -27,13 +42,9 @@ export const stepSchemaWithHiddenFields = z
       .describe('Identifier of the [robot](https://transloadit.com/docs/robots/) to execute'),
   })
   .and(robotsWithHiddenBotsAndFieldsSchema)
-export const stepsSchemaWithHiddenFields = z
+export const stepsSchemaWithHiddenFields: z.ZodType<StepsWithHiddenFields> = z
   .record(stepSchemaWithHiddenFields)
   .describe('Contains Assembly Instructions.')
-export type StepWithHiddenFields = z.infer<typeof stepSchemaWithHiddenFields>
-export type StepWithHiddenFieldsInput = z.input<typeof stepSchemaWithHiddenFields>
-export type StepsWithHiddenFields = z.infer<typeof stepsSchemaWithHiddenFields>
-export type StepsWithHiddenFieldsInput = z.input<typeof stepsSchemaWithHiddenFields>
 const optionalStepsWithHiddenFieldsSchema = stepsSchemaWithHiddenFields.optional()
 
 export const fieldsSchema = z
@@ -48,7 +59,27 @@ export const notifyUrlSchema = z
   .optional()
   .nullable()
   .describe(
-    'Transloadit can send a Pingback to your server when the Assembly is completed. We’ll send the Assembly status in a form url-encoded JSON string inside of a transloadit field in a multipart POST request to the URL supplied here.',
+    "Transloadit can send a Pingback to your server when the Assembly is completed. We'll send the Assembly status in a form url-encoded JSON string inside of a transloadit field in a multipart POST request to the URL supplied here. Use `notification_payload` to reduce the payload size (e.g. `without_uploads`, `without_results`); the same filtering applies to notification replays.",
+  )
+
+export type NotificationPayloadFilter =
+  | 'without_result_meta_data'
+  | 'without_results'
+  | 'without_upload_meta_data'
+  | 'without_uploads'
+
+export const notificationPayloadFilterValues = [
+  'without_result_meta_data',
+  'without_results',
+  'without_upload_meta_data',
+  'without_uploads',
+] as const satisfies readonly NotificationPayloadFilter[]
+
+export const notificationPayloadSchema = z
+  .array(z.enum(notificationPayloadFilterValues))
+  .optional()
+  .describe(
+    'Controls the size of the payload sent in Assembly notifications (both the initial notification and any notification replays). An empty array (default) sends the complete Assembly status. Add `"without_upload_meta_data"` to strip `meta` from files in `uploads`. Add `"without_result_meta_data"` to strip `meta` from files in `results`. Add `"without_uploads"` to strip `uploads` entirely. Add `"without_results"` to strip `results` entirely. Filtering is applied before serialization, so using these options reduces memory use and helps avoid oversized-payload or OOM failures on large assemblies.',
   )
 
 export const templateIdSchema = z
@@ -122,6 +153,7 @@ const assemblyInstructionsSharedShape = {
       'Set this to false to disallow Overruling Templates at Runtime. If you set this to false then template_id and steps will be mutually exclusive and you may only supply one of those parameters. Recommended when deploying Transloadit in untrusted environments. This makes sense to set as part of a Template, rather than on the Assembly itself when creating it.',
     ),
   notify_url: notifyUrlSchema,
+  notification_payload: notificationPayloadSchema,
   fields: fieldsSchema,
   quiet: z
     .boolean()

package/src/alphalib/types/templateCredential.ts

@@ -30,6 +30,7 @@ export const templateCredentialsSchema = z
         'ftp',
         'google',
         'http',
+        'mega',
         'minio',
         'rackspace',
         's3',