Repository navigation
Conversation
The sync expanded single-line arrays in biome.json without changing any setting, and Biome 2.4.16 rejects the expanded file.
The API reworded these comments after the snapshot this sync copied, so the next sync would otherwise bring the same change again.
Both commands emit default-filled Steps, so the synced contract would change signed params and synced Templates for unchanged input: new inpainting, download and return_file_stubs defaults, no framerate for /video/merge and a newer default ImageMagick stack. Within this major they keep emitting what 6.9.1 emitted; explicit values pass through unchanged. The golden fixture is recorded from 6.9.1 with dummy credentials.
Earlier releases dropped search before sending. The contract now sends it and rejects an empty one, so an empty value keeps listing everything instead of throwing before the request.
List every type-breaking change found by diffing the built declarations, the additive exports, the Storage search handling and the defaults that auth signature and templates sync keep emitting. The SDK accepts the older ImageMagick stacks unchanged rather than aliasing them.
…alizers 6.9.1 forwarded download, inpainting, credentials, return_file_stubs and speaker_colors as unknown keys, unvalidated and uncoerced. auth signature and templates sync now do the same instead of rejecting null values, skipping Template files or turning quoted booleans into booleans. They also stop filling in the en-US source_language for ElevenLabs, which detects the language when it is omitted. Other commands keep validating the new parameters. The new parameters no longer trigger the unrecognized-parameter warning, since the contract now documents them.
Destructuring the rest of the options read every enumerable getter and lost inherited prefix and limit values whenever search was empty. Read the declared fields as the schema parse in 6.9.1 did, and treat a null search like an omitted one.
Describe which new parameters auth signature and templates sync forward unchanged, the validation other commands now apply to them, the Storage search limits, what API2 does with deprecated ImageMagick stacks, and the changed deprecated stack literal types. Keep provider keys in Template Credentials rather than presenting them as Step parameters.
…arch type Reading the declared fields first sent a workspace-wide listing for an array and threw a TypeError for null; 6.9.1 rejected both with the schema's ZodError. Non-objects now reach the schema unchanged. The method's input type also accepts search: null, which it treats as no filter and which compiled when earlier releases ignored the field.
…earch Name every command that now validates the new parameters, limit the unchanged-output promise to input the previous release accepted, and list the search values that are rejected before sending.
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Type-breaking contract sync (proposed: minor for
@transloadit/node,transloadit,@transloadit/types,@transloadit/zod; patch for@transloadit/mcp-server). Parsed/file/serve,/image/generateand/transloadit/importInstructions gain requireddownload,inpaintingandreturn_file_stubs; parsed/video/mergeframeratecan beundefined;/document/splitpagescan contain numbers;provideraddselevenlabs; Robot unions and name enums add/document/watermark;imageGenerateModelIdentifiersadds two models; Robot metadata replacesapplyCommunityPlanMediaTrim;runtimeStackVersions.imagemagickliteral types change. Draft: the release decision is the maintainers'.Why
The Robot schemas in this repository describe what the Transloadit API accepts and returns. They had fallen behind the API: a new Robot (
/document/watermark), the ElevenLabs provider, image inpainting controls, per-speaker subtitle colors, Storage asset search and upgraded ImageMagick stacks were missing, so the SDK's types, linter and CLI rejected or mistyped Instructions the API accepts.What
packages/node/src/alphalibupdated from API2. 41 files, +914 / −77.auth signatureandtemplates synckeep emitting what the previous release emitted for input it accepted. These two commands serialize default-filled Steps, so new contract defaults would otherwise have changed signed params and synced Template files, for example writinginpainting: "best_effort"over a stored Template's"strict". One documented map next to the serializer (previousStepDefaults, to be removed in the next major):inpainting,downloadorreturn_file_stubs;framerate: '1/5'to/video/mergeandimagemagick_stack: 'v2.0.10'where a Step sets neither (both are still accepted by the contract; the API runsv2.0.10onv2.0.11and may return a deprecation warning);source_languagedefault for the newelevenlabsprovider, so its language detection stays on.listStoredAssets()now sendssearch. An empty,nullor omittedsearchlists everything as before; other invalid values throw before the request. Non-object arguments are rejected as before.biome.jsonis unchanged from main.Size: 55 files, +1,746 / −100. Outside the synced schemas: SDK code and config 6 files (+98 / −8), tests 4 files (+638), changeset (+78), generated docs 3 files.
Type-breaking changes
Verified by building declarations for
mainand this branch and diffing them. Each has aType-breaking:bullet in the changeset with who is affected and how to adapt./file/serveInstructions always containdownload(defaultfalse)./image/generateInstructions always containinpainting(default'best_effort')./transloadit/importInstructions always containreturn_file_stubs(defaultfalse)./video/mergeframeratecan beundefined(the parse-time default is gone)./document/splitpagesalso accepts positive integers./speech/transcribeand/text/speakprovidercan beelevenlabs./document/watermark.imageGenerateModelIdentifiersincludesopenai/gpt-image-2.6-flareandopenai/gpt-image-2.6-sunburst.applyCommunityPlanMediaTrimis replaced byplanMediaTrimandplanWatermarkOutput.runtimeStackVersions.imagemagick:defaultis'v2.0.11',validis['v2.0.11', 'v3.0.2'], and thedeprecatedtargets moved accordingly.No input type accepts less.
Runtime behavior that does change
Stated in the changeset; per CONTRIBUTING.md this is contract validation, not SDK surface:
assemblies create --steps,assemblies replay --steps,templates create,templates modifyandrunnow validate the five new parameters instead of forwarding them with an "Unrecognized step parameters" warning. For exampledownload: nullis rejected anddownload: 'false'is sent asfalse.auth signatureandtemplates synccan now accept input the previous release rejected where the contract widened, for example/document/splitwithpages: 5.listStoredAssets()with a non-emptysearchnow filters; earlier releases dropped it.Tests
auth signatureandtemplates syncproduce byte-identical signature params,createTemplateparams and written Template files as the previous release (fixture generated frommain, includingnullvalues, quoted booleans and empty arrays for the new parameters). It failed on the sync commit and passes now.listStoredAssets: empty,null, real and invalidsearch; options objects with prototype getters; array andnullarguments; a type test forsearch: null.yarn verify:fullandyarn checkpass in a clean copy (1,201 node unit tests).yarn parity:transloaditfails here as it does onmain: its checked-in fingerprint predates the current release.Review notes
searchregression, an incomplete changeset and stale docs; round 2 found that parameters new to the contract were being validated and coerced in the two legacy serializers, and the ElevenLabs language default; round 3 found argument-shape and type regressions inlistStoredAssetsand changeset precision. All are addressed above; the last fixes have not had another round.planMediaTrim/planWatermarkOutputJSDoc, "isolated PDF processor" in/document/watermark, the inpainting "boundary" wording, and "Default file-count ceiling enforced per processing or import Job".🤖 Claimed by kvz on
framework1/node-sdksince 2026-11-19 · resume:claude --resume d38be187-7c9b-4ff3-9d1a-6a15c9743991