@transloadit/node 4.1.9 → 4.3.0

package/src/alphalib/templateMerge.ts

@@ -0,0 +1,32 @@
+import merge from 'lodash-es/merge.js'
+import type { ResponseTemplateContent, TemplateContent } from '../apiTypes.ts'
+import type { AssemblyInstructionsInput } from './types/template.ts'
+
+export function mergeTemplateContent(
+  template: TemplateContent | ResponseTemplateContent,
+  params?: AssemblyInstructionsInput,
+): AssemblyInstructionsInput {
+  const templateContent = structuredClone(template) as TemplateContent | ResponseTemplateContent
+  const templateRecord = templateContent as Record<string, unknown>
+
+  if (templateContent.allow_steps_override == null) {
+    templateContent.allow_steps_override = true
+  }
+
+  if (params?.steps != null && templateContent.allow_steps_override === false) {
+    throw new Error('TEMPLATE_DENIES_STEPS_OVERRIDE')
+  }
+
+  if (params == null) {
+    return templateContent as AssemblyInstructionsInput
+  }
+
+  const paramsRecord = { ...params } as Record<string, unknown>
+  for (const key of Object.keys(templateRecord)) {
+    if (paramsRecord[key] === null && templateRecord[key] !== null) {
+      paramsRecord[key] = templateRecord[key]
+    }
+  }
+
+  return merge({}, templateRecord, paramsRecord) as AssemblyInstructionsInput
+}

package/src/alphalib/types/assemblyStatus.ts

@@ -78,6 +78,8 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'DIGITALOCEAN_STORE_ACCESS_DENIED',
   'DO_NOT_REUSE_ASSEMBLY_IDS',
   'DOCUMENT_CONVERT_UNSUPPORTED_CONVERSION',
+  'DOCUMENT_OPTIMIZE_UNSUPPORTED_INPUT',
+  'DOCUMENT_OPTIMIZE_VALIDATION',
   'DOCUMENT_SPLIT_VALIDATION',
   'FILE_DOWNLOAD_ERROR',
   'FILE_FILTER_DECLINED_FILE',
@@ -112,6 +114,7 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'INVALID_AUTH_REFERER_PARAMETER',
   'INVALID_FILE_META_DATA',
   'INVALID_FORM_DATA',
+  'INVALID_URL_ENCODING',
   'INVALID_INPUT_ERROR',
   'INVALID_PARAMS_FIELD',
   'INVALID_SIGNATURE',
@@ -156,6 +159,9 @@ export const assemblyStatusErrCodeSchema = z.enum([
   'TMP_FILE_DOWNLOAD_ERROR',
   'USER_COMMAND_ERROR',
   'VERIFIED_EMAIL_REQUIRED',
+  'VIDEO_CONCAT_INVALID_INPUT',
+  'VIDEO_CONCAT_NO_OUTPUT',
+  'VIDEO_CONCAT_VALIDATION',
   'VIDEO_ENCODE_VALIDATION',
   'VIMEO_IMPORT_FAILURE',
   'WORKER_JOB_ERROR',
@@ -379,7 +385,7 @@ export const assemblyStatusUploadSchema = z
     basename: z.string(),
     ext: z.string(),
     size: z.number(),
-    mime: z.string(),
+    mime: z.string().nullable(),
     type: z.string().nullable(),
     field: z.string().nullable(),
     md5hash: z.string().nullable(),
@@ -614,6 +620,8 @@ export const assemblyStatusErrSchema = assemblyStatusBaseSchema
     reason: z.string().optional(),
     step: z.string().optional(),
     previousStep: z.string().optional(),
+    file: z.string().optional(),
+    name: z.string().optional(),
     path: z.string().optional(),
     exitCode: z.number().nullable().optional(),
     exitSignal: z.string().nullable().optional(),

package/src/alphalib/types/assemblyUrls.ts

@@ -1,5 +1,5 @@
+import type { AssemblyStatus } from './assemblyStatus.ts'
 import {
-  type AssemblyStatus,
   isAssemblyBusyStatus,
   isAssemblyTerminalError,
   isAssemblyTerminalOk,
@@ -56,10 +56,7 @@ const assemblyUrlKeys = ['assembly_ssl_url', 'assembly_url', 'assemblyUrl'] as c
 const isRecord = (value: unknown): value is Record<string, unknown> =>
   value !== null && typeof value === 'object' && !Array.isArray(value)
 
-const pickString = (
-  record: Record<string, unknown>,
-  keys: readonly string[],
-): string | null => {
+const pickString = (record: Record<string, unknown>, keys: readonly string[]): string | null => {
   for (const key of keys) {
     const value = record[key]
     if (typeof value === 'string' && value.length > 0) return value

package/src/alphalib/types/robots/_index.ts

@@ -104,6 +104,11 @@ import {
   interpolatableRobotDocumentOcrInstructionsSchema,
   interpolatableRobotDocumentOcrInstructionsWithHiddenFieldsSchema,
 } from './document-ocr.ts'
+import {
+  meta as documentOptimizeMeta,
+  interpolatableRobotDocumentOptimizeInstructionsSchema,
+  interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema,
+} from './document-optimize.ts'
 import {
   meta as documentSplitMeta,
   interpolatableRobotDocumentSplitInstructionsSchema,
@@ -435,6 +440,7 @@ const robotStepsInstructions = [
   interpolatableRobotDocumentConvertInstructionsSchema,
   interpolatableRobotDocumentMergeInstructionsSchema,
   interpolatableRobotDocumentOcrInstructionsSchema,
+  interpolatableRobotDocumentOptimizeInstructionsSchema,
   interpolatableRobotFileReadInstructionsSchema,
   interpolatableRobotDocumentSplitInstructionsSchema,
   interpolatableRobotDocumentThumbsInstructionsSchema,
@@ -519,6 +525,7 @@ const robotStepsInstructionsWithHiddenFields = [
   interpolatableRobotDocumentConvertInstructionsWithHiddenFieldsSchema,
   interpolatableRobotDocumentMergeInstructionsWithHiddenFieldsSchema,
   interpolatableRobotDocumentOcrInstructionsWithHiddenFieldsSchema,
+  interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema,
   interpolatableRobotFileReadInstructionsWithHiddenFieldsSchema,
   interpolatableRobotDocumentSplitInstructionsWithHiddenFieldsSchema,
   interpolatableRobotDocumentThumbsInstructionsWithHiddenFieldsSchema,
@@ -632,6 +639,7 @@ export const robotsMeta = {
   documentConvertMeta,
   documentMergeMeta,
   documentOcrMeta,
+  documentOptimizeMeta,
   documentSplitMeta,
   documentThumbsMeta,
   dropboxImportMeta,
@@ -824,6 +832,12 @@ export type {
   InterpolatableRobotDocumentOcrInstructionsWithHiddenFields,
   InterpolatableRobotDocumentOcrInstructionsWithHiddenFieldsInput,
 } from './document-ocr.ts'
+export type {
+  InterpolatableRobotDocumentOptimizeInstructions,
+  InterpolatableRobotDocumentOptimizeInstructionsInput,
+  InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFields,
+  InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsInput,
+} from './document-optimize.ts'
 export type {
   InterpolatableRobotDocumentSplitInstructions,
   InterpolatableRobotDocumentSplitInstructionsInput,

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

@@ -40,6 +40,7 @@ export const robotNames = z.enum([
   'DocumentConvertRobot',
   'DocumentMergeRobot',
   'DocumentSplitRobot',
+  'DocumentOptimizeRobot',
   'DocumentAutorotateRobot',
   'HtmlConvertRobot',
   'ImageResizeRobot',

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

@@ -0,0 +1,180 @@
+import { z } from 'zod'
+
+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: {
+      optimized: {
+        robot: '/document/optimize',
+        use: ':original',
+        preset: 'ebook',
+      },
+    },
+  },
+  example_code_description: 'Optimize PDF file size using the ebook preset:',
+  extended_description: `
+This <dfn>Robot</dfn> reduces PDF file sizes. It recompresses images, subsets fonts, and applies various optimizations to reduce file size while maintaining acceptable quality.
+
+## Quality Presets
+
+The Robot supports four quality presets that control the trade-off between file size and quality:
+
+| Preset | DPI | Use Case | Typical Savings |
+|--------|-----|----------|-----------------|
+| \`screen\` | 72 | Screen viewing, smallest files | ~86% |
+| \`ebook\` | 150 | Good balance of quality/size | ~71% |
+| \`printer\` | 300 | Print quality | Moderate |
+| \`prepress\` | Highest | Press-ready, largest files | Minimal |
+
+## Use Cases
+
+- Reducing storage costs for archived documents
+- Faster document delivery and download
+- Meeting email attachment size limits
+- Mobile-optimized document viewing
+`,
+  minimum_charge: 2097152,
+  output_factor: 0.5,
+  override_lvl1: 'Document Processing',
+  purpose_sentence: 'reduces the file size of PDF documents',
+  purpose_verb: 'optimize',
+  purpose_word: 'optimize PDF',
+  purpose_words: 'Optimize PDF file size',
+  service_slug: 'document-processing',
+  slot_count: 10,
+  title: 'Reduce PDF file size',
+  typical_file_size_mb: 2.0,
+  typical_file_type: 'document',
+  name: 'DocumentOptimizeRobot',
+  priceFactor: 1,
+  queueSlotCount: 10,
+  minimumCharge: 2097152,
+  isAllowedForUrlTransform: true,
+  trackOutputFileSize: true,
+  isInternal: false,
+  removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+  stage: 'beta',
+}
+
+export const robotDocumentOptimizeInstructionsSchema = robotBase
+  .merge(robotUse)
+  .extend({
+    robot: z.literal('/document/optimize').describe(`
+This Robot reduces PDF file sizes. It recompresses images, subsets fonts, and applies various optimizations to reduce file size while maintaining acceptable quality.
+
+## Quality Presets
+
+The Robot supports four quality presets that control the trade-off between file size and quality:
+
+| Preset | DPI | Use Case | Typical Savings |
+|--------|-----|----------|-----------------|
+| \`screen\` | 72 | Screen viewing, smallest files | ~86% |
+| \`ebook\` | 150 | Good balance of quality/size | ~71% |
+| \`printer\` | 300 | Print quality | Moderate |
+| \`prepress\` | Highest | Press-ready, largest files | Minimal |
+`),
+    preset: z
+      .enum(['screen', 'ebook', 'printer', 'prepress'])
+      .default('ebook')
+      .describe(`
+The quality preset to use for optimization. Each preset provides a different balance between file size and quality:
+
+- \`screen\` - Lowest quality, smallest file size. Best for screen viewing only. Images are downsampled to 72 DPI.
+- \`ebook\` - Good balance of quality and size. Suitable for most purposes. Images are downsampled to 150 DPI.
+- \`printer\` - High quality suitable for printing. Images are kept at 300 DPI.
+- \`prepress\` - Highest quality for professional printing. Minimal compression applied.
+`),
+    image_dpi: z
+      .number()
+      .int()
+      .min(36)
+      .max(600)
+      .optional()
+      .describe(`
+Target DPI (dots per inch) for embedded images. When specified, this overrides the DPI setting from the preset.
+
+Higher DPI values result in better image quality but larger file sizes. Lower values produce smaller files but may result in pixelated images when printed.
+
+Common values:
+- 72 - Screen viewing
+- 150 - eBooks and general documents
+- 300 - Print quality
+- 600 - High-quality print
+`),
+    compress_fonts: z
+      .boolean()
+      .default(true)
+      .describe(`
+Whether to compress embedded fonts. When enabled, fonts are compressed to reduce file size.
+`),
+    subset_fonts: z
+      .boolean()
+      .default(true)
+      .describe(`
+Whether to subset embedded fonts, keeping only the glyphs that are actually used in the document. This can significantly reduce file size for documents that only use a small portion of a font's character set.
+`),
+    remove_metadata: z
+      .boolean()
+      .default(false)
+      .describe(`
+Whether to strip document metadata (title, author, keywords, etc.) from the PDF. This can provide a small reduction in file size and may be useful for privacy.
+`),
+    linearize: z
+      .boolean()
+      .default(true)
+      .describe(`
+Whether to linearize (optimize for Fast Web View) the output PDF. Linearized PDFs can begin displaying in a browser before they are fully downloaded, improving the user experience for web delivery.
+`),
+    compatibility: z
+      .enum(['1.4', '1.5', '1.6', '1.7', '2.0'])
+      .default('1.7')
+      .describe(`
+The PDF version compatibility level. Lower versions have broader compatibility but fewer features. Higher versions support more advanced features but may not open in older PDF readers.
+
+- \`1.4\` - Acrobat 5 compatibility, most widely supported
+- \`1.5\` - Acrobat 6 compatibility
+- \`1.6\` - Acrobat 7 compatibility
+- \`1.7\` - Acrobat 8+ compatibility (default)
+- \`2.0\` - PDF 2.0 standard
+`),
+  })
+  .strict()
+
+export const robotDocumentOptimizeInstructionsWithHiddenFieldsSchema =
+  robotDocumentOptimizeInstructionsSchema.extend({
+    result: z
+      .union([z.literal('debug'), robotDocumentOptimizeInstructionsSchema.shape.result])
+      .optional(),
+  })
+
+export type RobotDocumentOptimizeInstructions = z.infer<
+  typeof robotDocumentOptimizeInstructionsSchema
+>
+export type RobotDocumentOptimizeInstructionsWithHiddenFields = z.infer<
+  typeof robotDocumentOptimizeInstructionsWithHiddenFieldsSchema
+>
+
+export const interpolatableRobotDocumentOptimizeInstructionsSchema = interpolateRobot(
+  robotDocumentOptimizeInstructionsSchema,
+)
+export type InterpolatableRobotDocumentOptimizeInstructions =
+  InterpolatableRobotDocumentOptimizeInstructionsInput
+
+export type InterpolatableRobotDocumentOptimizeInstructionsInput = z.input<
+  typeof interpolatableRobotDocumentOptimizeInstructionsSchema
+>
+
+export const interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema =
+  interpolateRobot(robotDocumentOptimizeInstructionsWithHiddenFieldsSchema)
+export type InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFields = z.infer<
+  typeof interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema
+>
+export type InterpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsInput = z.input<
+  typeof interpolatableRobotDocumentOptimizeInstructionsWithHiddenFieldsSchema
+>

package/src/alphalib/typings/json-to-ast.d.ts

@@ -0,0 +1,34 @@
+declare module 'json-to-ast' {
+  export interface JsonToAstLocation {
+    start: { line: number; column: number }
+  }
+
+  export interface ObjectPropertyNode {
+    key: { value: string; loc?: JsonToAstLocation }
+    value: ValueNode
+    loc?: JsonToAstLocation
+  }
+
+  export interface LiteralNode {
+    type: 'Literal'
+    value: unknown
+    loc?: JsonToAstLocation
+  }
+
+  export interface ArrayNode {
+    type: 'Array'
+    children: ValueNode[]
+    loc?: JsonToAstLocation
+  }
+
+  export interface ObjectNode {
+    type: 'Object'
+    children: ObjectPropertyNode[]
+    loc?: JsonToAstLocation
+  }
+
+  export type ValueNode = LiteralNode | ArrayNode | ObjectNode
+
+  const parse: (source: string, options?: { loc?: boolean }) => ValueNode
+  export default parse
+}

package/src/cli/commands/assemblies.ts

@@ -13,15 +13,19 @@ import got from 'got'
 import PQueue from 'p-queue'
 import * as t from 'typanion'
 import { z } from 'zod'
+import { formatLintIssue } from '../../alphalib/assembly-linter.lang.en.ts'
 import { tryCatch } from '../../alphalib/tryCatch.ts'
 import type { Steps, StepsInput } from '../../alphalib/types/template.ts'
 import { stepsSchema } from '../../alphalib/types/template.ts'
 import type { CreateAssemblyParams, ReplayAssemblyParams } from '../../apiTypes.ts'
+import type { LintFatalLevel } from '../../lintAssemblyInstructions.ts'
+import { lintAssemblyInstructions } from '../../lintAssemblyInstructions.ts'
 import type { CreateAssemblyOptions, Transloadit } from '../../Transloadit.ts'
-import { createReadStream, formatAPIError, streamToBuffer } from '../helpers.ts'
+import { lintingExamples } from '../docs/assemblyLintingExamples.ts'
+import { createReadStream, formatAPIError, readCliInput, streamToBuffer } from '../helpers.ts'
 import type { IOutputCtl } from '../OutputCtl.ts'
 import { ensureError, isErrnoException } from '../types.ts'
-import { AuthenticatedCommand } from './BaseCommand.ts'
+import { AuthenticatedCommand, UnauthenticatedCommand } from './BaseCommand.ts'
 
 // --- From assemblies.ts: Schemas and interfaces ---
 export interface AssemblyListOptions {
@@ -48,6 +52,15 @@ export interface AssemblyReplayOptions {
   assemblies: string[]
 }
 
+export interface AssemblyLintOptions {
+  steps?: string
+  template?: string
+  fatal?: LintFatalLevel
+  fix?: boolean
+  providedInput?: string
+  json?: boolean
+}
+
 const AssemblySchema = z.object({
   id: z.string(),
 })
@@ -163,6 +176,97 @@ export async function replay(
   }
 }
 
+export async function lint(
+  output: IOutputCtl,
+  client: Transloadit | null,
+  { steps, template, fatal, fix, providedInput, json }: AssemblyLintOptions,
+): Promise<number> {
+  let content: string | null
+  let isStdin: boolean
+  let inputPath: string | undefined
+  try {
+    ;({
+      content,
+      isStdin,
+      path: inputPath,
+    } = await readCliInput({
+      inputPath: steps,
+      providedInput,
+      allowStdinWhenNoPath: true,
+    }))
+  } catch (error) {
+    output.error(ensureError(error).message)
+    return 1
+  }
+
+  if (content == null && template == null) {
+    output.error('assemblies lint requires --steps or stdin input unless --template is provided')
+    return 1
+  }
+
+  if (fix && content == null && template != null) {
+    output.error('assemblies lint --fix requires local instructions (stdin or --steps)')
+    return 1
+  }
+
+  let result: Awaited<ReturnType<typeof lintAssemblyInstructions>>
+  try {
+    if (template != null) {
+      if (!client) {
+        output.error('Missing client for template lookup')
+        return 1
+      }
+      result = await client.lintAssemblyInstructions({
+        assemblyInstructions: content ?? undefined,
+        templateId: template,
+        fatal,
+        fix,
+      })
+    } else {
+      result = await lintAssemblyInstructions({
+        assemblyInstructions: content ?? undefined,
+        fatal,
+        fix,
+      })
+    }
+  } catch (error) {
+    output.error(ensureError(error).message)
+    return 1
+  }
+
+  const issues = result.issues
+
+  if (fix && isStdin) {
+    if (result.fixedInstructions == null) {
+      output.error('No fixed output available.')
+      return 1
+    }
+    process.stdout.write(`${result.fixedInstructions}\n`)
+    for (const issue of issues) {
+      const line = formatLintIssue(issue)
+      if (issue.type === 'warning') output.warn(line)
+      else output.error(line)
+    }
+    return result.success ? 0 : 1
+  }
+
+  if (fix && inputPath && result.fixedInstructions != null) {
+    await fsp.writeFile(inputPath, result.fixedInstructions)
+  }
+
+  if (json) {
+    output.print({ ...result, issues }, result)
+  } else if (issues.length === 0) {
+    output.print('No issues found', result)
+  } else {
+    for (const issue of issues) {
+      output.print(formatLintIssue(issue), issue)
+    }
+  }
+
+  return result.success ? 0 : 1
+}
+
 // --- From assemblies-create.ts: Helper classes and functions ---
 interface NodeWatcher {
   on(event: 'error', listener: (err: Error) => void): void
@@ -1373,3 +1477,58 @@ export class AssembliesReplayCommand extends AuthenticatedCommand {
     return undefined
   }
 }
+
+export class AssembliesLintCommand extends UnauthenticatedCommand {
+  static override paths = [
+    ['assemblies', 'lint'],
+    ['assembly', 'lint'],
+    ['a', 'lint'],
+  ]
+
+  static override usage = Command.Usage({
+    category: 'Assemblies',
+    description: 'Lint Assembly Instructions',
+    details: `
+      Lint Assembly Instructions locally using Transloadit's linter.
+      Provide instructions via --steps or stdin (steps-only JSON is accepted).
+      Optionally pass --template to
+      merge template content with steps before linting (same merge behavior as the API).
+    `,
+    examples: lintingExamples,
+  })
+
+  steps = Option.String('--steps,-s', {
+    description: 'JSON file with Assembly Instructions (use "-" for stdin)',
+  })
+
+  template = Option.String('--template,-t', {
+    description:
+      'Template ID to merge before linting. If the template forbids step overrides, linting will fail when steps are provided.',
+  })
+
+  fatal = Option.String('--fatal', {
+    description: 'Treat issues at this level as fatal (error or warning)',
+    validator: t.isEnum(['error', 'warning']),
+  })
+
+  fix = Option.Boolean('--fix', false, {
+    description:
+      'Apply auto-fixes. For files, overwrites in place. For stdin, writes fixed JSON to stdout.',
+  })
+
+  protected async run(): Promise<number | undefined> {
+    let client: Transloadit | null = null
+    if (this.template) {
+      if (!this.setupClient()) return 1
+      client = this.client
+    }
+
+    return await lint(this.output, client, {
+      steps: this.steps,
+      template: this.template,
+      fatal: this.fatal as LintFatalLevel | undefined,
+      fix: this.fix,
+      json: this.json,
+    })
+  }
+}

package/src/cli/commands/auth.ts

@@ -8,7 +8,7 @@ import {
 } from '../../alphalib/types/template.ts'
 import type { OptionalAuthParams } from '../../apiTypes.ts'
 import { Transloadit } from '../../Transloadit.ts'
-import { getEnvCredentials } from '../helpers.ts'
+import { getEnvCredentials, readCliInput } from '../helpers.ts'
 import { UnauthenticatedCommand } from './BaseCommand.ts'
 
 type UrlParamPrimitive = string | number | boolean
@@ -68,19 +68,6 @@ function normalizeUrlParams(params?: Record<string, unknown>): NormalizedUrlPara
   return normalized
 }
 
-async function readStdin(): Promise<string> {
-  if (process.stdin.isTTY) return ''
-
-  process.stdin.setEncoding('utf8')
-  let data = ''
-
-  for await (const chunk of process.stdin) {
-    data += chunk
-  }
-
-  return data
-}
-
 const getCredentials = getEnvCredentials
 
 // Result type for signature operations
@@ -217,8 +204,12 @@ export async function runSig(options: RunSigOptions = {}): Promise<void> {
     return
   }
 
-  const rawInput = options.providedInput ?? (await readStdin())
-  const result = generateSignature(rawInput.trim(), credentials, options.algorithm)
+  const { content } = await readCliInput({
+    providedInput: options.providedInput,
+    allowStdinWhenNoPath: true,
+  })
+  const rawInput = (content ?? '').trim()
+  const result = generateSignature(rawInput, credentials, options.algorithm)
 
   if (result.ok) {
     process.stdout.write(`${result.output}\n`)
@@ -238,8 +229,12 @@ export async function runSmartSig(options: RunSmartSigOptions = {}): Promise<voi
     return
   }
 
-  const rawInput = options.providedInput ?? (await readStdin())
-  const result = generateSmartCdnUrl(rawInput.trim(), credentials)
+  const { content } = await readCliInput({
+    providedInput: options.providedInput,
+    allowStdinWhenNoPath: true,
+  })
+  const rawInput = (content ?? '').trim()
+  const result = generateSmartCdnUrl(rawInput, credentials)
 
   if (result.ok) {
     process.stdout.write(`${result.output}\n`)
@@ -287,8 +282,9 @@ export class SignatureCommand extends UnauthenticatedCommand {
       return 1
     }
 
-    const rawInput = await readStdin()
-    const result = generateSignature(rawInput.trim(), credentials, this.algorithm)
+    const { content } = await readCliInput({ allowStdinWhenNoPath: true })
+    const rawInput = (content ?? '').trim()
+    const result = generateSignature(rawInput, credentials, this.algorithm)
 
     if (result.ok) {
       process.stdout.write(`${result.output}\n`)
@@ -340,8 +336,9 @@ export class SmartCdnSignatureCommand extends UnauthenticatedCommand {
       return 1
     }
 
-    const rawInput = await readStdin()
-    const result = generateSmartCdnUrl(rawInput.trim(), credentials)
+    const { content } = await readCliInput({ allowStdinWhenNoPath: true })
+    const rawInput = (content ?? '').trim()
+    const result = generateSmartCdnUrl(rawInput, credentials)
 
     if (result.ok) {
       process.stdout.write(`${result.output}\n`)

package/src/cli/commands/index.ts

@@ -6,6 +6,7 @@ import {
   AssembliesCreateCommand,
   AssembliesDeleteCommand,
   AssembliesGetCommand,
+  AssembliesLintCommand,
   AssembliesListCommand,
   AssembliesReplayCommand,
 } from './assemblies.ts'
@@ -46,6 +47,7 @@ export function createCli(): Cli {
   cli.register(AssembliesGetCommand)
   cli.register(AssembliesDeleteCommand)
   cli.register(AssembliesReplayCommand)
+  cli.register(AssembliesLintCommand)
 
   // Templates commands
   cli.register(TemplatesCreateCommand)

package/src/cli/docs/assemblyLintingExamples.ts

@@ -0,0 +1,9 @@
+export const lintingExamples: Array<[string, string]> = [
+  ['Lint a steps file', 'transloadit assemblies lint --steps steps.json'],
+  ['Lint from stdin', 'cat steps.json | transloadit assemblies lint --steps -'],
+  [
+    'Lint with template merge',
+    'transloadit assemblies lint --template TEMPLATE_ID --steps steps.json',
+  ],
+  ['Auto-fix in place', 'transloadit assemblies lint --steps steps.json --fix'],
+]