{"record":{"id":"99b26bb3fc4d6ce1","repo":"remotion-dev/remotion","slug":"no-recommended-version-found-for-transformers-pa","errorCode":null,"errorMessage":"No recommended version found for ${TRANSFORMERS_PACKAGE}","messagePattern":"No recommended version found for (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/studio/src/helpers/optional-package-dependencies.ts","lineNumber":26,"sourceCode":"]);\n\nexport const withRequiredAuxiliaryPackages = (\n\tdependencies: readonly PackageInstallSpec[],\n): PackageInstallSpec[] => {\n\tif (\n\t\t!dependencies.some((dependency) =>\n\t\t\tpackagesRequiringTransformers.has(dependency.name),\n\t\t) ||\n\t\tdependencies.some((dependency) => dependency.name === TRANSFORMERS_PACKAGE)\n\t) {\n\t\treturn [...dependencies];\n\t}\n\n\tconst transformers = extraPackages.find(\n\t\t(pkg) => pkg.name === TRANSFORMERS_PACKAGE,\n\t);\n\tif (!transformers) {\n\t\tthrow new Error(`No recommended version found for ${TRANSFORMERS_PACKAGE}`);\n\t}\n\n\treturn [\n\t\t...dependencies,\n\t\t{name: transformers.name, version: transformers.version},\n\t];\n};\n","sourceCodeStart":8,"sourceCodeEnd":34,"githubUrl":"https://github.com/remotion-dev/remotion/blob/b2f4e34732f3c6c222ea029413e22dc402218cd7/packages/studio/src/helpers/optional-package-dependencies.ts#L8-L34","documentation":"withRequiredAuxiliaryPackages looks up the recommended version of the transformers package (TRANSFORMERS_PACKAGE) inside the extraPackages list. If the list does not contain an entry for that package, this error is thrown. It is an internal invariant: the recommended-version catalog must always include transformers.","triggerScenarios":"Calling withRequiredAuxiliaryPackages with an extraPackages/dependencies array that lacks an entry whose name equals TRANSFORMERS_PACKAGE (e.g. after the catalog was modified or filtered).","commonSituations":"Custom builds of Remotion Studio where optional-dependency metadata was trimmed; upgrading Studio while a stale or incomplete dependency list is passed in.","solutions":["Ensure the extraPackages list passed to the function includes an entry for the transformers package with a valid version.","Restore the default optional-package-dependencies catalog if it was customized or filtered.","Update @remotion/studio to the latest version so the built-in catalog matches the code expectation.","If self-hosting/forking, re-add {name: TRANSFORMERS_PACKAGE, version: <recommended>} to the list."],"exampleFix":"// before\nwithRequiredAuxiliaryPackages(dependencies, extraPackages.filter(p => p.name !== 'remotion-transformers'));\n// after\nwithRequiredAuxiliaryPackages(dependencies, extraPackages);","handlingStrategy":"try-catch","validationCode":"if (!extraPackages.some(p => p.name === TRANSFORMERS_PACKAGE)) {\n  throw new Error('extraPackages is missing the transformers entry');\n}","typeGuard":null,"tryCatchPattern":"try {\n  return withRequiredAuxiliaryPackages(dependencies, extraPackages);\n} catch (e) {\n  if (e.message.startsWith('No recommended version found')) {\n    extraPackages.push({name: TRANSFORMERS_PACKAGE, version: DEFAULT_VERSION});\n    return withRequiredAuxiliaryPackages(dependencies, extraPackages);\n  }\n  throw e;\n}","preventionTips":["Never filter the default optional-package-dependencies catalog.","Keep @remotion/studio updated so catalogs and code stay in sync.","In forks, assert the transformers entry exists in tests.","Log the extraPackages contents when customizing dependency lists."],"tags":["dependencies","packages","internal-invariant"],"backgroundTag":"missing-dependency","analyzedSha":"b2f4e34732f3c6c222ea029413e22dc402218cd7","analyzedAt":"2026-09-09T13:27:51.281Z","contentChangedAt":"2026-09-09T13:27:51.281Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}