@transloadit/node 6.5.0 → 6.6.1

package/dist/alphalib/types/templateValues.js

@@ -0,0 +1,117 @@
+import { formatSimpleValueReason } from "../renderSimpleValue.js";
+/** Usage in MiB charged for each dynamically evaluated Assembly expression. */
+export const expressionEvaluationUsageMebibytes = 0.2;
+/** Character domain shared by stored Template IDs and their pagination cursors. */
+// biome-ignore lint/suspicious/noControlCharactersInRegex: Stored Template IDs allow the full ASCII range.
+export const storedTemplateIdentifierPattern = /^[\x00-\x7F]*$/u;
+/** Template Assembly Status retention values shared by runtime validation and contracts. */
+export const templateAssemblyStatusExpiries = Object.freeze({
+    noTmpFileRetention: 'NoSave',
+    oneDay: '1day',
+    sevenDays: '7days',
+    thirtyDays: '30days',
+    ninetyDays: '90days',
+});
+/** Template transcoding-result retention values shared by runtime validation and contracts. */
+export const templateTranscodingResultExpiries = Object.freeze({
+    noTmpFileRetention: 'NoSave',
+    oneDay: '1day',
+});
+/** Default storage lifecycle selections; separate from upload and execution phase timeouts. */
+export const templateRetentionDefaults = Object.freeze({
+    assemblyStatus: templateAssemblyStatusExpiries.ninetyDays,
+    transcodingResult: templateTranscodingResultExpiries.oneDay,
+});
+export const templateListFieldValues = [
+    'account_id',
+    'assembly_status_expiry',
+    'cron_auth_key_id',
+    'cron_enabled',
+    'cron_max_concurrent_runs',
+    'cron_region',
+    'cron_schedule_with_seconds',
+    'created',
+    'deleted',
+    'encryption_version',
+    'id',
+    'json',
+    'last_used',
+    'modified',
+    'name',
+    'require_signature_auth',
+    'transcoding_result_expiry',
+];
+export const templateListDefaultFields = [
+    'id',
+    'name',
+    'json',
+    'encryption_version',
+    'require_signature_auth',
+    'assembly_status_expiry',
+    'transcoding_result_expiry',
+    'last_used',
+    'created',
+    'modified',
+];
+export const templateListOrderValues = ['asc', 'desc'];
+export const templateListSortValues = ['id', 'name', 'created', 'modified', 'last_used'];
+export const templateIncludeBuiltinModes = ['none', 'latest', 'all'];
+export const templateIncludeBuiltinValues = [
+    ...templateIncludeBuiltinModes,
+    'exclusively-latest',
+    'exclusively-all',
+];
+/** Canonical Template-list defaults shared by API2 and generated clients. */
+export const templateListDefaults = Object.freeze({
+    includeBuiltin: 'none',
+    keywords: '',
+    order: 'desc',
+    page: 1,
+    pagesize: 850,
+    sort: 'created',
+});
+/** Maximum page size accepted by Template listing. */
+export const templateListMaxPageSize = 850;
+/** Code-unit length retained for the private admin Workspace override. */
+export const templateListWorkspaceIdCodeUnits = 32;
+/** Maximum customer-supplied characters retained in a Template-list error reason. */
+export const templateListInvalidRequestValueMaxCharacters = 200;
+/** Handler-priority Template-list validation reasons shared by runtime and contract enforcement. */
+export const templateListInvalidRequestReasons = {
+    order: {
+        message: 'Invalid order (must be "asc" or "desc")',
+        value: 'string',
+    },
+    sort: {
+        message: 'Invalid sort (must be "created", "modified", "name", "id" or "last_used")',
+        suffix: '.',
+        value: 'string',
+    },
+    pagesize: {
+        message: `Invalid pagesize (must be between 1 and ${templateListMaxPageSize})`,
+        suffix: '.',
+        value: 'integer-prefix',
+    },
+    page: {
+        message: 'Invalid page',
+        suffix: '.',
+        value: 'integer-prefix',
+    },
+    account_id: {
+        message: 'Invalid accountId',
+        suffix: '.',
+        value: 'string',
+    },
+    include_builtin: {
+        message: 'Invalid include_builtin',
+        value: 'string',
+    },
+};
+/** Formats one established Template-list reason from its shared contract fact. */
+export function formatTemplateListInvalidRequestReason(field, value) {
+    const reason = templateListInvalidRequestReasons[field];
+    return formatSimpleValueReason(typeof value === 'number' && reason.value === 'integer-prefix'
+        ? { ...reason, value: 'string' }
+        : reason, value, templateListInvalidRequestValueMaxCharacters);
+}
+//# sourceMappingURL=templateValues.js.map

package/dist/alphalib/types/templateValues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateValues.js","sourceRoot":"","sources":["../../../src/alphalib/types/templateValues.ts"],"names":[],"mappings":"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"}

package/dist/cli/stepsInput.d.ts

@@ -1,7 +1,7 @@
 import type { StepsInput } from '../alphalib/types/template.ts';
 import type { IOutputCtl } from './OutputCtl.ts';
 import { z } from 'zod';
-/** CLI inputs can be partial overrides; API2 validates OCR after merging their runtime context. */
+/** CLI overrides warn on new parameters and defer contextual OCR checks to API2. */
 export declare function createCliStepsSchema(output?: Pick<IOutputCtl, 'warn'>): z.ZodType<StepsInput>;
 export declare function parseStepsInputJson(content: string, output?: Pick<IOutputCtl, 'warn'>): StepsInput;
 export declare function readStepsInputFile(filePath: string, output?: Pick<IOutputCtl, 'warn'>): Promise<StepsInput>;

package/dist/cli/stepsInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stepsInput.d.ts","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAIhD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAevB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,UAAU,CA0CZ;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,OAAO,CAAC,UAAU,CAAC,CAMrB"}
+{"version":3,"file":"stepsInput.d.ts","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAIhD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAUvB,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAgDvB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,UAAU,CA0CZ;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAW,GACzC,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/cli/stepsInput.js

@@ -6,9 +6,38 @@ import { refineDocumentExtractOcr } from "../alphalib/types/robots/document-extr
 import { refineTransloaditImportSelector } from "../alphalib/types/robots/transloadit-import.js";
 import { CliInputError, formatSchemaIssues } from "./errors.js";
 const stepsWrapperSchema = z.object({ steps: z.record(z.unknown()) });
-/** CLI inputs can be partial overrides; API2 validates OCR after merging their runtime context. */
+/** CLI overrides warn on new parameters and defer contextual OCR checks to API2. */
 export function createCliStepsSchema(output = console) {
-    const cliStepSchema = robotsSchema
+    const cliStepSchema = z
+        .object({ robot: z.string() })
+        .catchall(z.unknown())
+        .transform((step, context) => {
+        let validated = robotsSchema.safeParse(step, { path: context.path });
+        const unknownKeys = new Set();
+        if (!validated.success) {
+            for (const issue of validated.error.issues) {
+                // Only new top-level Robot parameters are advisory; nested objects stay strict.
+                if (issue.code !== 'unrecognized_keys' || issue.path.length !== context.path.length)
+                    continue;
+                for (const key of issue.keys)
+                    unknownKeys.add(key);
+            }
+            if (unknownKeys.size > 0) {
+                validated = robotsSchema.safeParse(Object.fromEntries(Object.entries(step).filter(([key]) => !unknownKeys.has(key))), { path: context.path });
+            }
+        }
+        if (!validated.success) {
+            for (const issue of validated.error.issues) {
+                // Keep nested union diagnostics rooted at the Step while addIssue prefixes its own path.
+                context.addIssue({ ...issue, path: issue.path.slice(context.path.length) });
+            }
+            return z.NEVER;
+        }
+        if (unknownKeys.size > 0) {
+            output.warn(`${context.path.join('.')}: Unrecognized step parameters: ${[...unknownKeys].join(', ')}. Preserving them for API validation when submitted.`);
+        }
+        return { ...step, ...validated.data };
+    })
         .superRefine(refineTransloaditImportSelector)
         .superRefine((step, context) => {
         // API2 merges Template defaults before Robot validation. New OCR checks must not reject

package/dist/cli/stepsInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepsInput.js","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stepsInput.js","sourceRoot":"","sources":["../../src/cli/stepsInput.ts"],"names":[],"mappings":"AAGA,OAAO,GAAG,MAAM,kBAAkB,CAAA;AAElC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAA;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAA;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,gDAAgD,CAAA;AAChG,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;AAErE,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAClC,SAAmC,OAAO;IAE1C,MAAM,aAAa,GAAG,CAAC;SACpB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;SAC7B,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SACrB,SAAS,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QAC3B,IAAI,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;QACpE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;QACrC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC3C,gFAAgF;gBAChF,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM;oBACjF,SAAQ;gBACV,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI;oBAAE,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACpD,CAAC;YACD,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzB,SAAS,GAAG,YAAY,CAAC,SAAS,CAChC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EACjF,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CACvB,CAAA;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC3C,yFAAyF;gBACzF,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC7E,CAAC;YACD,OAAO,CAAC,CAAC,KAAK,CAAA;QAChB,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,mCAAmC,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sDAAsD,CAC9I,CAAA;QACH,CAAC;QACD,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,CAAA;IACvC,CAAC,CAAC;SACD,WAAW,CAAC,+BAA+B,CAAC;SAC5C,WAAW,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QAC7B,wFAAwF;QACxF,oFAAoF;QACpF,wBAAwB,CAAC,IAAI,EAAE;YAC7B,GAAG,OAAO;YACV,QAAQ,CAAC,KAAK;gBACZ,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAChE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,KAAK,CAAC,OAAO,IAAI,yBAAyB,EAAE,CAAC,CAAA;YACxE,CAAC;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACJ,OAAO,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,SAAmC,OAAO;IAE1C,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,aAAa,CAAC,2CAA2C,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACxF,CAAC;IACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACpD,IAAI,UAAU,GAAG,MAAM,CAAA;IACvB,+EAA+E;IAC/E,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpE,kFAAkF;QAClF,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACtE,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,aAAa,CACrB,yBAAyB,kBAAkB,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAC5E,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAClC,CAAA;QACH,CAAC;QACD,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAA;IAC1C,CAAC;IACD,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IACpE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvB,MAAM,IAAI,aAAa,CAAC,yBAAyB,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE;YAC7F,KAAK,EAAE,SAAS,CAAC,KAAK;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,UAAqD,CAAA;IACzE,MAAM,cAAc,GAAG,SAAS,CAAC,IAA+C,CAAA;IAEhF,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE;QACxD,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;QACrD,OAAO;YACL,QAAQ;YACR,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAClF;SACF,CAAA;IACH,CAAC,CAAC,CACW,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,SAAmC,OAAO;IAE1C,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;IACvE,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,aAAa,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IACxF,CAAC;IACD,OAAO,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC7C,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@transloadit/node",
-  "version": "6.5.0",
-  "description": "Node.js SDK for Transloadit",
+  "version": "6.6.1",
+  "description": "Node.js SDK and `transloadit` CLI for Transloadit",
   "homepage": "https://github.com/transloadit/node-sdk/tree/main/packages/node",
   "bugs": {
     "url": "https://github.com/transloadit/node-sdk/issues"

package/src/alphalib/renderSimpleValue.ts

@@ -0,0 +1,120 @@
+import { truncateCodePointsWithEllipsis, truncateStringWithEllipsis } from './truncateString.ts'
+
+/** A safe scalar rendering policy for one customer-visible validation reason. */
+export interface SimpleValueReason {
+  readonly message: string
+  readonly suffix?: string
+  readonly value: 'integer-prefix' | 'string' | 'trimmed-string'
+}
+
+type SimpleArrayItem = string | number | boolean | bigint | null | Date
+
+function isSimpleArrayItem(value: unknown): value is SimpleArrayItem {
+  return (
+    value === null ||
+    value instanceof Date ||
+    typeof value === 'string' ||
+    typeof value === 'number' ||
+    typeof value === 'boolean' ||
+    typeof value === 'bigint'
+  )
+}
+
+function isSimpleValueArray(value: unknown): value is SimpleArrayItem[] {
+  return Array.isArray(value) && value.every(isSimpleArrayItem)
+}
+
+function renderSimpleArrayItem(value: SimpleArrayItem): string {
+  return value === null ? '' : String(value)
+}
+
+function* renderSimpleArrayCharacters(
+  values: readonly SimpleArrayItem[],
+  trim: boolean,
+): Generator<string, void, undefined> {
+  for (let index = 0; index < values.length; index += 1) {
+    if (index > 0) {
+      yield ','
+    }
+    let renderedItem = renderSimpleArrayItem(values[index])
+    if (trim && index === 0) {
+      renderedItem = renderedItem.trimStart()
+    }
+    if (trim && index === values.length - 1) {
+      renderedItem = renderedItem.trimEnd()
+    }
+    yield* renderedItem
+  }
+}
+
+/**
+ * Renders a scalar, Date, or flat scalar array without traversing arbitrary objects. Semantic
+ * predicates use the complete string; customer-facing reasons use the bounded formatter below.
+ */
+export function renderSimpleValueAsString(value: unknown): string | undefined {
+  if (
+    typeof value === 'string' ||
+    typeof value === 'number' ||
+    typeof value === 'boolean' ||
+    typeof value === 'bigint'
+  ) {
+    return String(value)
+  }
+  if (value === null) {
+    return 'null'
+  }
+  if (value instanceof Date) {
+    return Date.prototype.toString.call(value)
+  }
+  if (isSimpleValueArray(value)) {
+    return value.map(renderSimpleArrayItem).join(',')
+  }
+  return undefined
+}
+
+/** Formats a bounded validation reason without traversing or stringifying arbitrary objects. */
+export function formatSimpleValueReason(
+  reason: SimpleValueReason,
+  value: unknown,
+  maxCharacters: number,
+): string {
+  const suffix = reason.suffix ?? ''
+  if (reason.value === 'integer-prefix') {
+    const renderedValue = renderSimpleValueAsString(value)
+    if (renderedValue == null) {
+      return `${reason.message}${suffix}`
+    }
+
+    const parsedValue = Number.parseInt(renderedValue, 10)
+    const normalizedValue = Number.isFinite(parsedValue) ? String(parsedValue) : renderedValue
+    if (normalizedValue === '') {
+      return `${reason.message}${suffix}`
+    }
+    return `${reason.message}: ${truncateStringWithEllipsis(normalizedValue, maxCharacters)}${suffix}`
+  }
+
+  if (Array.isArray(value)) {
+    if (!isSimpleValueArray(value)) {
+      return `${reason.message}${suffix}`
+    }
+    const renderedValue = truncateCodePointsWithEllipsis(
+      renderSimpleArrayCharacters(value, reason.value === 'trimmed-string'),
+      maxCharacters,
+    )
+    return renderedValue === ''
+      ? `${reason.message}${suffix}`
+      : `${reason.message}: ${renderedValue}${suffix}`
+  }
+
+  const renderedValue = renderSimpleValueAsString(value)
+  if (renderedValue == null) {
+    return `${reason.message}${suffix}`
+  }
+
+  const normalizedValue = reason.value === 'trimmed-string' ? renderedValue.trim() : renderedValue
+  if (normalizedValue === '') {
+    return `${reason.message}${suffix}`
+  }
+
+  return `${reason.message}: ${truncateStringWithEllipsis(normalizedValue, maxCharacters)}${suffix}`
+}

package/src/alphalib/truncateString.ts

@@ -0,0 +1,23 @@
+/** Lazily truncates Unicode code points and marks a truncated value with an ellipsis. */
+export function truncateCodePointsWithEllipsis(
+  codePoints: Iterable<string>,
+  maxCharacters: number,
+): string {
+  if (!Number.isSafeInteger(maxCharacters) || maxCharacters < 0) {
+    throw new Error('String truncation requires a nonnegative safe character limit')
+  }
+
+  const characters: string[] = []
+  for (const character of codePoints) {
+    if (characters.length === maxCharacters) {
+      return `${characters.join('')}…`
+    }
+    characters.push(character)
+  }
+  return characters.join('')
+}
+
+/** Truncates a string by Unicode code points and marks a truncated value with an ellipsis. */
+export function truncateStringWithEllipsis(value: string, maxCharacters: number): string {
+  return truncateCodePointsWithEllipsis(value, maxCharacters)
+}

package/src/alphalib/types/robots/_instructions-primitives.ts

@@ -828,6 +828,22 @@ const deprecatedFfmpegVersions = formatEnglishList([
   ),
 ])
 
+/** Common per-input concat fade behavior; Robot-specific transition controls stay owner-local. */
+export function getConcatFadeDescription(media: 'audio' | 'video'): string {
+  const timing =
+    media === 'audio'
+      ? 'Audio fade-outs start on a whole-second boundary and may finish before the input ends.'
+      : 'Video fade durations are rounded down to whole frames and capped at the duration of each input.'
+
+  return `
+When concatenating at least two files, a positive value fades out the ${media} of each input and fades in every input after the first. There is no fade-in at the beginning of the output, but the fade-out is also applied to the last input.
+
+The value is a duration in seconds. For example, \`0.5\` means 500 milliseconds. Omit this parameter or set it to \`0\` to disable these per-input fades. They do not overlap clips or insert additional time between them.
+
+${timing}
+`
+}
+
 export const robotParameterDocs = {
   adaptive_filtering: {
     description: `
@@ -2075,6 +2091,12 @@ export const vimeoBase = z
       .optional()
       .describe(`
 Please create your associated <dfn>Template Credentials</dfn> in your Transloadit account and use the name of your <dfn>Template Credentials</dfn> as this parameter's value. They will contain the values for your Vimeo access token.
+
+For /vimeo/import, create your own app at [developer.vimeo.com/apps](https://developer.vimeo.com/apps), open \`Generate Access Token\`, choose \`Authenticated (you)\`, and select \`Public\`, \`Private\`, and \`Video Files\` (\`public private video_files\`). Generate the personal access token, then choose **Vimeo** and **Paste a personal access token** in the Console. The token is stored as \`access_token\` and is never displayed back in the Console. Saving checks your Vimeo account and the token’s scopes. Video file links also require an eligible Vimeo account and video permissions.
+
+Vimeo OAuth in the Console supports /vimeo/store. It cannot grant \`video_files\` for other members’ accounts because Transloadit is not a Vimeo partner. Imports require your own personal access token. To use that token for /vimeo/store too, also grant \`Upload\`, \`Edit\`, and \`Interact\` (\`upload edit interact\`) and ensure your Vimeo app has upload access.
+
+Updating a credential does not run OAuth again or add permissions. To reconnect, **Remove** the credential (which revokes its token at Vimeo), then create a new credential with the same name. For a personal token, generate a new one before saving it again. Revocation also affects any other use of that token. See the [Vimeo credential instructions](/docs/topics/template-credentials/#vimeo).
 `),
   })
   .strict()
@@ -2172,6 +2194,9 @@ While we recommend to use <dfn>Template Credentials</dfn> at all times, some use
   })
   .strict()
 
+/** Default SSH/SFTP port when no explicit connection port is supplied. */
+export const sftpDefaultPort = 22
+
 export type SftpBase = z.infer<typeof sftpBase>
 export const sftpBase = z
   .object({
@@ -2184,7 +2209,7 @@ Please create your associated <dfn>Template Credentials</dfn> in your Transloadi
 While we recommend to use <dfn>Template Credentials</dfn> at all times, some use cases demand dynamic credentials for which using <dfn>Template Credentials</dfn> is too unwieldy because of their static nature. If you have this requirement, feel free to use the following parameters instead: \`"host"\`, \`"port"\`, \`"user"\`, \`"public_key"\` (optional).
 `),
     host: z.string().optional(),
-    port: port.default(21).describe('The port to use for the FTP connection.'),
+    port: port.default(sftpDefaultPort).describe('The port to use for the SFTP connection.'),
     user: z.string().optional(),
     public_key: z.string().optional(),
   })
@@ -2333,6 +2358,11 @@ export const filterConditionPartSchema = z.tuple([
 export type FilterCondition = z.infer<typeof filterCondition>
 export const filterCondition = z.union([z.null(), z.string(), z.array(filterConditionPartSchema)])
 
+/** English Turbo guidance shared by the public parameter and supporting video FAQ. */
+export const videoTurboParameterDocumentation = `Splits the video into multiple chunks so that each chunk can be encoded in parallel before all encoded chunks are stitched back together to form the result video. This comes at the expense of extra Priority Job Slots and may prove to be counter-productive for very small video files.
+
+VP8 output and unresolved video-codec expressions use normal encoding even when \`turbo\` is \`true\`.`
+
 /**
  * Parameters specific to the /video/encode robot. Useful for typing robots that pass files to /video/encode.
  */
@@ -2391,12 +2421,7 @@ Forces the video to be rotated by the specified degree integer. Currently, only
       .describe(`
 Enables hinting for mp4 files, for RTP/RTSP streaming.
 `),
-    turbo: z
-      .boolean()
-      .default(false)
-      .describe(`
-Splits the video into multiple chunks so that each chunk can be encoded in parallel before all encoded chunks are stitched back together to form the result video. This comes at the expense of extra <dfn>Priority Job Slots</dfn> and may prove to be counter-productive for very small video files.
-`),
+    turbo: z.boolean().default(false).describe(videoTurboParameterDocumentation),
     chunk_duration: z
       .number()
       .int()
@@ -2404,6 +2429,8 @@ Splits the video into multiple chunks so that each chunk can be encoded in paral
       .optional()
       .describe(`
 Allows you to specify the duration of each chunk when \`turbo\` is set to \`true\`. This means you can take advantage of that feature while using fewer <dfn>Priority Job Slots</dfn>. For instance, the longer each chunk is, the fewer <dfn>Encoding Jobs</dfn> will need to be used.
+
+Requested durations below 5 seconds are treated as 5 seconds.
 `),
     watermark_url: z
       .union([z.literal(''), httpUrlSchema])

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

@@ -0,0 +1,211 @@
+import type { RobotVideoGenerateInstructions } from './video-generate.ts'
+
+import { videoGenerateDefaultModelIdentifier } from './_ai-models.ts'
+
+// Keep the schema wording portable without exposing the server's provider policy to SDKs.
+export { videoGenerationParameterEnforcementDate } from './_video-generate-description.ts'
+
+const optionalVideoParameters = [
+  'seed',
+  'aspect_ratio',
+  'height',
+  'width',
+  'style',
+  'duration',
+  'fps',
+  'motion_amount',
+  'camera_motion',
+  'negative_prompt',
+  'reference_strength',
+] satisfies (keyof RobotVideoGenerateInstructions)[]
+
+const ltxAspectRatioError = 'aspect_ratio must be a nonempty string for lightricks/ltx-video.'
+
+/** Stable code included in Assembly warning text and structured server logs. */
+export const videoGenerationParameterWarningCode = 'VIDEO_GENERATE_PARAMETER_IGNORED'
+
+/** Flip this one flag on the enforcement date; both policy paths have regression coverage. */
+export const videoGenerationParameterValidation = { enforceUnsupportedParameters: false }
+
+type VideoGenerationParameters = Pick<
+  RobotVideoGenerateInstructions,
+  'model' | 'prompt' | (typeof optionalVideoParameters)[number]
+>
+
+interface VideoGenerationModel {
+  replicateModel: `${string}/${string}`
+  parameters: readonly (typeof optionalVideoParameters)[number][]
+  imageInput?: string
+  imageMimeTypes?: readonly string[]
+  requiresImage?: boolean
+}
+
+// https://platform.minimax.io/docs/api-reference/video-generation-i2v#body-first-frame-image
+const minimaxImageMimeTypes = ['image/jpeg', 'image/png', 'image/webp']
+
+/** Verified Replicate video capabilities; model schemas do not accept a generic video input. */
+// Unavailable luma/ray and image-only luma/photon stay excluded in both modes. The transition
+// applies to ignored settings on supported video models, preserving the other validation fixes.
+export const videoGenerationModels: Record<string, VideoGenerationModel> = {
+  // https://replicate.com/minimax/video-01/api/schema: fixed six-second output, no duration input.
+  'minimax/video-01': {
+    replicateModel: 'minimax/video-01',
+    parameters: [],
+    imageInput: 'first_frame_image',
+    imageMimeTypes: minimaxImageMimeTypes,
+  },
+  'minimax/video-01-live': {
+    replicateModel: 'minimax/video-01-live',
+    parameters: [],
+    imageInput: 'first_frame_image',
+    imageMimeTypes: minimaxImageMimeTypes,
+    requiresImage: true,
+  },
+  // https://replicate.com/tencent/hunyuan-video/api/schema: length is specified in frames.
+  'tencent/hunyuan-video': {
+    replicateModel: 'tencent/hunyuan-video',
+    parameters: ['seed', 'height', 'width', 'fps'],
+  },
+  // https://replicate.com/lightricks/ltx-video/api/schema: length is specified in frames.
+  'lightricks/ltx-video': {
+    replicateModel: 'lightricks/ltx-video',
+    parameters: ['seed', 'aspect_ratio', 'negative_prompt'],
+    imageInput: 'image',
+  },
+}
+
+/** Looks up only configured model names, excluding inherited object properties. */
+export function getVideoGenerationModel(model: string): VideoGenerationModel | undefined {
+  return Object.hasOwn(videoGenerationModels, model) ? videoGenerationModels[model] : undefined
+}
+
+/** Identifies known unsupported frame formats without rejecting legacy CLI inputs lacking MIME. */
+export function getVideoGenerationImageFormatError(
+  modelName: string,
+  mime: string | null | undefined,
+): string | undefined {
+  const supported = getVideoGenerationModel(modelName)?.imageMimeTypes
+  if (!mime || !supported || supported.includes(mime)) return undefined
+  return `Model ${modelName} supports only JPEG, PNG, or WebP input images. Convert the image before using it.`
+}
+
+/** Shares safe value constraints between migration warnings and later enforcement errors. */
+export function getPreviouslyOmittedVideoGenerationValueError(
+  instructions: VideoGenerationParameters,
+  parameter: (typeof optionalVideoParameters)[number],
+  hasImage: boolean,
+): string | undefined {
+  if (instructions.model === 'tencent/hunyuan-video') {
+    if (
+      parameter === 'fps' &&
+      instructions.fps != null &&
+      (!Number.isInteger(instructions.fps) || instructions.fps < 1)
+    ) {
+      return 'fps must be a positive integer for tencent/hunyuan-video.'
+    }
+    if (parameter === 'height' || parameter === 'width') {
+      const value = instructions[parameter]
+      if (value != null && (value < 16 || value > 1280 || value % 16 !== 0)) {
+        return `${parameter} must be a multiple of 16 between 16 and 1280 for tencent/hunyuan-video.`
+      }
+    }
+  }
+  if (
+    instructions.model === 'lightricks/ltx-video' &&
+    parameter === 'aspect_ratio' &&
+    !hasImage &&
+    instructions.aspect_ratio === ''
+  ) {
+    return ltxAspectRatioError
+  }
+  return undefined
+}
+
+/** Enumerates ignored scalar settings without including customer-supplied values. */
+export function getUnsupportedVideoGenerationParameters(
+  instructions: VideoGenerationParameters,
+  hasImage = false,
+): (typeof optionalVideoParameters)[number][] {
+  const model = getVideoGenerationModel(instructions.model ?? videoGenerateDefaultModelIdentifier)
+  if (!model) return []
+  return optionalVideoParameters.filter(
+    (parameter) =>
+      instructions[parameter] != null &&
+      (!model.parameters.includes(parameter) ||
+        (hasImage && parameter === 'aspect_ratio') ||
+        getPreviouslyOmittedVideoGenerationValueError(instructions, parameter, hasImage) != null),
+  )
+}
+
+/** Enforces model constraints and, after the transition, rejects ignored scalar settings. */
+export function getVideoGenerationParameterError(
+  instructions: VideoGenerationParameters,
+  hasImage = false,
+): string | undefined {
+  const modelName = instructions.model ?? videoGenerateDefaultModelIdentifier
+  const model = getVideoGenerationModel(modelName)
+  if (!model) return `Model ${modelName} is not supported for video generation.`
+  const unsupported = getUnsupportedVideoGenerationParameters(instructions, hasImage)
+  if (videoGenerationParameterValidation.enforceUnsupportedParameters && unsupported.length > 0) {
+    const parameter = unsupported[0]
+    const valueError = getPreviouslyOmittedVideoGenerationValueError(
+      instructions,
+      parameter,
+      hasImage,
+    )
+    if (valueError) return valueError
+    const imageConstraint =
+      hasImage && parameter === 'aspect_ratio' && model.parameters.includes(parameter)
+        ? ' with an input image'
+        : ''
+    return `Model ${modelName} does not support ${parameter}${imageConstraint}. Omit this parameter or select a model that supports it.`
+  }
+  // Whitespace was forwarded before this change, unlike the previously omitted empty string.
+  if (
+    modelName === 'lightricks/ltx-video' &&
+    !hasImage &&
+    instructions.aspect_ratio != null &&
+    instructions.aspect_ratio !== '' &&
+    instructions.aspect_ratio.trim() === ''
+  ) {
+    return ltxAspectRatioError
+  }
+  return undefined
+}
+
+/** Requires necessary images immediately; unsupported inputs share the compatibility window. */
+export function getVideoGenerationImageError(
+  instructions: Pick<VideoGenerationParameters, 'model' | 'aspect_ratio'>,
+  hasImage: boolean,
+): string | undefined {
+  const modelName = instructions.model ?? videoGenerateDefaultModelIdentifier
+  const model = getVideoGenerationModel(modelName)
+  if (!model) return `Model ${modelName} is not supported for video generation.`
+  if (model.requiresImage && !hasImage) return `Model ${modelName} requires an input image.`
+  if (
+    videoGenerationParameterValidation.enforceUnsupportedParameters &&
+    hasImage &&
+    !model.imageInput
+  ) {
+    return `Model ${modelName} does not support an input image.`
+  }
+  return undefined
+}
+
+/** Builds only model-supported provider fields, preserving explicit zero values. */
+export function buildVideoGenerationInput(
+  instructions: VideoGenerationParameters,
+  hasImage = false,
+): Record<string, unknown> {
+  const error = getVideoGenerationParameterError(instructions, hasImage)
+  if (error) throw new Error(error)
+  const model = getVideoGenerationModel(instructions.model ?? videoGenerateDefaultModelIdentifier)
+  if (!model) throw new Error('Missing video generation model configuration.')
+  const unsupported = getUnsupportedVideoGenerationParameters(instructions, hasImage)
+  const input: Record<string, unknown> = { prompt: instructions.prompt }
+  for (const parameter of model.parameters) {
+    const value = instructions[parameter]
+    if (value != null && !unsupported.includes(parameter)) input[parameter] = value
+  }
+  return input
+}