{"record":{"id":"c8d5d1c155a10b66","repo":"remotion-dev/remotion","slug":"no-published-version-is-known-for-name","errorCode":null,"errorMessage":"No published version is known for ${name}","messagePattern":"No published version is known for (.+?)","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/browser-studio/src/download-project.ts","lineNumber":101,"sourceCode":"\nconst getPublicFileArchivePath = (path: string) => {\n\tconst relativePath = path.startsWith('/') ? path.slice(1) : path;\n\treturn `public/${validateRelativePath(relativePath)}`;\n};\n\nconst getPublishedVersion = ({\n\tname,\n\tdependencyVersions,\n}: {\n\tname: string;\n\tdependencyVersions: Record<string, string>;\n}) => {\n\tconst version =\n\t\tdependencyVersions[name] ??\n\t\t(name.startsWith('@remotion/') ? dependencyVersions.remotion : null);\n\n\tif (!version) {\n\t\tthrow new Error(`No published version is known for ${name}`);\n\t}\n\n\treturn version;\n};\n\nconst resolvePortableDependencySpec = ({\n\tdependencyVersions,\n\tname,\n\tspec,\n}: {\n\tdependencyVersions: Record<string, string>;\n\tname: string;\n\tspec: string;\n}) => {\n\tif (spec === 'catalog:') {\n\t\treturn getPublishedVersion({name, dependencyVersions});\n\t}\n","sourceCodeStart":83,"sourceCodeEnd":119,"githubUrl":"https://github.com/remotion-dev/remotion/blob/78fe4bb3fdb5a2cd68724393d63cb223db333fa7/packages/browser-studio/src/download-project.ts#L83-L119","documentation":"When Browser Studio downloads a portable project, getPublishedVersion resolves each dependency's version from a dependencyVersions map, falling back to the 'remotion' key for @remotion/* packages. If neither the package's own entry nor the remotion fallback yields a version, it throws because it cannot emit a valid package.json dependency range.","triggerScenarios":"The project depends on a package not present in dependencyVersions, or an @remotion/* package when the map has no 'remotion' key. Reproduced by adding a dependency the downloader was not given version metadata for.","commonSituations":"Adding a new dependency to the project without updating the dependencyVersions metadata; an unknown/non-published package; @remotion/* sub-package used while the remotion version is unknown; custom/local deps that have no published version.","solutions":["Ensure every dependency in the project is represented in the dependencyVersions map passed to the download flow.","For @remotion/* packages, ensure a 'remotion' version is present in the map (it is used as fallback).","Avoid non-published, local, or git-based dependencies in portable Browser Studio projects.","Regenerate the dependencyVersions metadata after adding or upgrading a package."],"exampleFix":"// before\n// dependencyVersions = { 'react': '19.0.0' }  // project also uses 'lodash'\n\n// after\n// dependencyVersions = { 'react': '19.0.0', 'lodash': '4.17.21', 'remotion': '4.0.0' }","handlingStrategy":"validation","validationCode":"const assertVersionKnown = (name: string, dependencyVersions: Record<string, string>) => {\n  const known = dependencyVersions[name] ??\n    (name.startsWith('@remotion/') ? dependencyVersions.remotion : undefined);\n  if (!known) {\n    throw new Error(`No published version known for ${name}; add it to dependencyVersions`);\n  }\n};\n// validate every project dependency before calling download","typeGuard":"const isVersionKnown = (name: string, dv: Record<string, string>): boolean =>\n  !!dv[name] || (!!dv.remotion && name.startsWith('@remotion/'));","tryCatchPattern":null,"preventionTips":["Keep dependencyVersions in sync with the project's actual dependencies.","Always include a 'remotion' version to cover @remotion/* fallbacks.","Avoid local, git, or non-published dependencies in portable Browser Studio projects.","Regenerate dependencyVersions metadata after each dependency add/upgrade."],"tags":["browser-studio","download","dependencies","versions","package-json"],"backgroundTag":null,"analyzedSha":"78fe4bb3fdb5a2cd68724393d63cb223db333fa7","analyzedAt":"2026-08-12T17:18:50.444Z","schemaVersion":2},"datasetVersion":"2026-08-12T18:17:37.767Z"}