CHANGELOG.md

Changelog

You may also want to refer to GitHub releases.

Note: This top-level changelog is maintained for the historical single-package v4.x.y tag series. Since the monorepo split and independent package versioning, release notes live in per-package changelogs under packages/*/CHANGELOG.md and in GitHub releases.

Roadmap

• Support more platforms than Node.js #153
• Other improvements, see #89
• Add JSON Schema export for v4 (@transloadit/jsonschema or subpath) once zod v4 tooling is stable.
• Consider promoting alphalib into its own workspace package if/when all consuming repos are v4‑ready.

Unreleased

• TBD

v4.1.4

Released: 2026-01-19.

Diff.

• Sync alphalib schema updates (ai-chat robot, new file-filter operators, updated assembly status codes).

v4.1.3

Released: 2026-01-17.

Diff.

• Publish initial patch releases for the split packages and legacy wrapper.

v4.1.2

Released: 2025-12-08.

Diff.

• CLI accepts TRANSLOADIT_AUTH_KEY/TRANSLOADIT_AUTH_SECRET as aliases for TRANSLOADIT_KEY/TRANSLOADIT_SECRET when authenticating commands.
• Internal: fix lint import ordering to keep CI green.

v4.1.1

Released: 2025-12-08.

Diff.

• CLI now accepts TRANSLOADIT_AUTH_KEY/TRANSLOADIT_AUTH_SECRET in addition to TRANSLOADIT_KEY/TRANSLOADIT_SECRET when authenticating commands.

v4.1.0

Released: 2025-12-08.

Diff.

• Add signal option to createAssembly() for cancelling in-flight HTTP requests and TUS uploads via AbortController
• Add signal and onPoll options to awaitAssemblyCompletion() for cancellation and early termination (useful for custom progress reporting or superseding assemblies in watch mode)
• Integrate transloadify CLI into the SDK, providing assemblies, templates, bills, and assembly-notifications commands
• Add --log-level (-l) CLI option using syslog severity levels (err=3, warn=4, notice=5, info=6, debug=7, trace=8)
• Add --endpoint CLI option for custom API endpoint (also reads TRANSLOADIT_ENDPOINT env var)
• Add --single-assembly flag to assemblies create for passing multiple input files to a single assembly
• Add --concurrency option to assemblies create to limit parallel processing (default: 5)
• Fix file descriptor exhaustion by closing streams immediately and creating fresh ones on demand
• Apply stricter biome lint rules (noExplicitAny, useAwait, noForEach, noNonNullAssertion)

v4.0.7

Released: 2025-11-26.

Diff.

• Update schemas to match the latest API changes.

v4.0.6

Released: 2025-11-04.

Diff.

• Re-export AssemblyInstructions and AssemblyInstructionsInput at the package entry to match the migration guide and TypeScript examples.

v4.0.5

Released: 2025-10-16.

Diff.

• Add smart_sig CLI to return Smart CDN URLs via getSignedSmartCDNUrl, making it suitable as the cross-SDK reference implementation.
• Add sig CLI command for generating request signatures, including an --algorithm flag for choosing the HMAC digest.
• Ensure the CLI entrypoint executes when invoked through npm/yarn bin shims by resolving symlinks before bootstrapping.
• Harden validation and tests around CLI invocation paths.

v4.0.2, v4.0.3, and v4.0.4 were broken releases

v4.0.1

Released: 2025-09-18.

Diff.

• Re-published v4.0.0 under v4.0.1 to fix release metadata. No functional changes.

v4.0.0

Released: 2025-09-18.

Diff.

• Breaking: Package is now pure ESM, requires Node.js 20+, and exports { Transloadit } instead of a default client.
• Breaking TransloaditError removed in favor of a new, slightly different ApiError.
• Added end-to-end TypeScript typings for robots, assemblies, templates, and responses, so assembly instructions now autocomplete every robot and its supported parameters. Notably, Assembly instructions and statuses are validates against rich TypeScript types; migrate to the new AssemblyInstructionsInput types and AssemblyStatus in responses.
• New rich error stacktraces that aid in debugging issues.
• Added opt-in validateResponses safeguard and a getSignedSmartCDNUrl helper for generating signed Smart CDN URLs.
• Fix broken rate limiting #217
• Modernized tooling, tests, and examples (Vitest, Biome, TypeScript examples). See MIGRATION.md for a guided upgrade path.

v3.0.2

Released: 2021-04-06.

Diff.

• Generate assembly IDs on the client to avoid relying on server timing.
• Completed TypeScript surface for assembly responses by adding missing output properties.

v3.0.1

Released: 2021-03-31.

Diff.

• Fixed the published default export to match the actual runtime client.

v3.0.0

Released: 2021-03-16.

Diff.

• Finalized the promise-based client by removing legacy wrappers and tightening trailing-slash validation.
• Expanded continuous testing, linting, and documentation coverage ahead of the stable v3 release.
• Improved createAssembly diagnostics by logging assembly IDs and exposing replayed assembly URLs.

v2.0.10

Released: 2020-02-25.

Diff.

• Update dependencies, thank you @dagreatbrendino

v2.0.9

Released: 2018-12-06.

Diff.

• Add more helpful message to assembly error (#73)
• Add Assembly ID to unknown errors
• Upgrade linting and fix newly found errors

v2.0.7

Released: 2018-12-06.

Diff.

• Fix Transloadit-Client header test for once and all (#62)
• Fix bug causing progressCb to only be fired once

v2.0.5

Released: 2018-12-06.

Diff.

• Make resize image example more usable irl
• Update Readme to include example for progressCb.
• Fix failing test due to version increase (#61)
• Update npm-run-all to lose event-stream dependency

v2.0.4

Released: 2018-11-05.

Diff.

• Send transloadit-client header (#59)

v2.0.3

Released: 2018-10-29.

Diff.

• When adding a stream that throws an error, do not send it to Transloadit

v2.0.2

Released: 2018-10-24.

Diff.

• Fix bug: invoke callback when there are no tus files to upload

v2.0.1

Released: 2018-06-18.

Diff.

• Fix bug: invoke callback when waitforcompmletion is false

v2.0.0

Released: 2018-06-08.

Diff.

• (MAJOR) Use of tus client to enable resumable uploads. (not strictly speaking breaking the api, but big enough of an implementation change to warant a major so you can take extra care things work well)
• Support Assembly Progress Callback (this supports progress during file uploads and assemby execution).

v1.11.0

Released: 2018-05-23.

Diff.

• Add Assembly URL to error console logs for easier debugging. (Q: should the node sdk log to console at all? should it not just work with callbacks and the caller decides what to write to what medium?)

v1.10.3

Released: 2018-01-09.

Diff.

• Remove unused region parameter (@tim-kos)

v1.10.2

Released: 2017-10-15.

Diff.

• Update lib files (@ifedapoolarewaju)

v1.10.1

Released: 2017-10-02.

Diff.

• fix: check path for only direct Readable instances (@ifedapoolarewaju)

v1.10.0

Released: 2017-09-28.

Diff.

• Do not retry infinitely if there is an unrecoverable error. Fixes #47. (@tim-kos)
• Add the ability to wait for the encoding results of an assembly before the callback to createAssembly() is called (@tim-kos)

v1.9.6

Released: 2017-09-26.

Diff.

• Fix bug that threw TypeError: Cannot read property 'body' of undefined (#48) (@kvz)
• Fix linting issues (@kvz)
• Refactor via invig.io (@kvz)
• Upgrade dependencies (@kvz)

v1.9.5

Released: 2017-09-26.

Diff.

• Start tracking CHANGELOG.md