feat: Link to project using name and version #1425

WIStudent · 2026-01-19T15:41:53Z

Description

This is another try to implement project links that use name and version and do not require uuid. The previous try at #45 seems to be abandoned.

Addressed Issue

resolves #41

Additional Details

This PR adds two additional vue routes:

`projects/:name/:version/*`

Its beforeEach navigation guard tries to lookup the uuid of the project using the /v1/project/lookup API endpoint. If a uuid was found, it redirects to projects/:uuid. If not, it redirects to the 404 page.

The /* at the end is used to keep trailing subpaths.

projects/MyProject/1.2.3/ -> projects/:uuid
projects/MyProject/1.2.3/components -> projects/:uuid/components

`projects/:name/:version`

The projects/:name/:version/* route will not match projects/MyProject/1.2.3 because it does not end with a /. That's why projects/:name/:version will redirect to projects/:name/:version/.

projects/:name/:version -> projects/:name/:version/ -> projects/:uuid

Checklist

I have read and understand the contributing guidelines
This PR introduces new or alters existing behavior, and I have updated the documentation accordingly

Signed-off-by: Tobias Trumm <tobias@tobiastrumm.de>

owasp-dt-bot · 2026-01-19T15:42:10Z

✅ Snyk checks have passed. No issues have been found so far.

Status	Scanner	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Copilot

Pull request overview

This PR implements a feature to allow linking to projects using their name and version instead of requiring the UUID. It adds two new Vue Router routes that perform a lookup of the project UUID via a new API endpoint and redirect to the existing UUID-based project routes.

Changes:

Added URL_PROJECT_LOOKUP API endpoint constant for project lookup by name and version
Added projects/:name/:version/* route with navigation guard that looks up UUID and redirects to UUID-based routes
Added projects/:name/:version route that redirects to the wildcard variant with a trailing slash

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

File	Description
src/shared/api.json	Adds the URL constant for the new project lookup API endpoint
src/router/index.js	Implements two new routes to support name/version-based project linking with UUID lookup and redirection logic

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-19T15:45:30Z

src/router/index.js

+        },
+        {
+          path: 'projects/:name/:version',
+          redirect: 'projects/:name/:version/',


The redirect path should be absolute (starting with '/') or use a function-based redirect. The current relative path may not work as expected. Consider changing to redirect: (to) => ({ path: /projects/${to.params.name}/${to.params.version}/ }) to ensure proper route resolution.

Suggested change

redirect: 'projects/:name/:version/',

redirect: (to) => ({

path: `/projects/${to.params.name}/${to.params.version}/`,

}),

Copilot · 2026-01-19T15:45:31Z

src/router/index.js

+                  ? `/${to.params.pathMatch}`
+                  : '';
+                next({
+                  path: `projects/${result.data.uuid}${trailingPathSegments}`,


The navigation redirect should include leading slash to make the path absolute. Change path: projects/${result.data.uuid}${trailingPathSegments} to `path: `/projects/${result.data.uuid}${trailingPathSegments} to ensure proper path resolution.

Suggested change

path: `projects/${result.data.uuid}${trailingPathSegments}`,

path: `/projects/${result.data.uuid}${trailingPathSegments}`,

Copilot · 2026-01-19T15:45:31Z

src/router/index.js

+                  path: `projects/${result.data.uuid}${trailingPathSegments}`,
+                  replace: true,
+                });
+              })
+              .catch(() => {
+                next({
+                  name: '404',


Query parameters from the original URL are not preserved during the redirect. If the original URL contains query parameters (e.g., for filtering or sorting), they will be lost. Consider preserving them by including query: to.query in the next() object alongside the path.

Suggested change

path: `projects/${result.data.uuid}${trailingPathSegments}`,

replace: true,

});

})

.catch(() => {

next({

name: '404',

path: `projects/${result.data.uuid}${trailingPathSegments}`,

query: to.query,

replace: true,

});

})

.catch(() => {

next({

name: '404',

query: to.query,

Copilot · 2026-01-19T15:45:32Z

src/router/index.js

+              .catch(() => {
+                next({
+                  name: '404',
+                  replace: true,
+                });


The error handling catches all errors uniformly, but different error types should potentially be handled differently. For example, a 404 (not found) is different from a 401 (unauthorized) or 500 (server error). Consider checking the error response status to provide more appropriate error handling, especially for authorization errors which might need different treatment than simple "not found" scenarios.

Suggested change

.catch(() => {

next({

name: '404',

replace: true,

});

.catch((error) => {

const status = error && error.response && error.response.status;

if (status === 404) {

next({

name: '404',

replace: true,

});

} else if (status === 401 || status === 403) {

next({

name: 'Login',

replace: true,

});

} else {

// Cancel navigation on unexpected errors to avoid misreporting them as "not found"

next(false);

}

Copilot · 2026-01-19T15:45:32Z

src/router/index.js

+            const searchParams = new URLSearchParams({
+              name: to.params.name,
+              version: to.params.version,


Project names and versions may contain special characters that need URL encoding. The current implementation doesn't decode these parameters before sending them to the API. If a project name contains special characters (e.g., spaces, slashes), the URL parameters extracted from to.params will already be decoded by Vue Router, but this should be verified. Additionally, consider validating that the name and version parameters don't contain path separators or other invalid characters that could cause routing issues.

Suggested change

const searchParams = new URLSearchParams({

name: to.params.name,

version: to.params.version,

const decodeParam = (value) => {

if (typeof value !== 'string') {

return '';

}

try {

return decodeURIComponent(value);

} catch (e) {

// If decoding fails (malformed escape sequences), fall back to the original value

return value;

}

};

const isValidSegment = (value) =>

typeof value === 'string' && !/[\\/]/.test(value);

const name = decodeParam(to.params.name);

const version = decodeParam(to.params.version);

if (!isValidSegment(name) || !isValidSegment(version)) {

next({

name: '404',

replace: true,

});

return;

}

const searchParams = new URLSearchParams({

name,

version,

Copilot · 2026-01-19T15:45:32Z

src/router/index.js

+                  path: `projects/${result.data.uuid}${trailingPathSegments}`,
+                  replace: true,
+                });
+              })
+              .catch(() => {
+                next({
+                  name: '404',


URL hash fragments are not preserved during the redirect. If the original URL contains a hash (e.g., for in-page navigation or state), it will be lost. Consider preserving the hash by including hash: to.hash in the next() object alongside the path.

Suggested change

path: `projects/${result.data.uuid}${trailingPathSegments}`,

replace: true,

});

})

.catch(() => {

next({

name: '404',

path: `projects/${result.data.uuid}${trailingPathSegments}`,

hash: to.hash,

replace: true,

});

})

.catch(() => {

next({

name: '404',

hash: to.hash,

feat: Link to project using name and version

0bad0e7

Signed-off-by: Tobias Trumm <tobias@tobiastrumm.de>

Copilot AI review requested due to automatic review settings January 19, 2026 15:41

Copilot started reviewing on behalf of WIStudent January 19, 2026 15:42 View session

Copilot AI reviewed Jan 19, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Link to project using name and version #1425

feat: Link to project using name and version #1425

Uh oh!

WIStudent commented Jan 19, 2026

Uh oh!

owasp-dt-bot commented Jan 19, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Copilot AI Jan 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

-          redirect: 'projects/:name/:version/',
+          redirect: (to) => ({
+            path: `/projects/${to.params.name}/${to.params.version}/`,
+          }),

	path: `projects/${result.data.uuid}${trailingPathSegments}`,
	path: `/projects/${result.data.uuid}${trailingPathSegments}`,

-              .catch(() => {
-                next({
-                  name: '404',
-                  replace: true,
-                });
+              .catch((error) => {
+                const status = error && error.response && error.response.status;
+                if (status === 404) {
+                  next({
+                    name: '404',
+                    replace: true,
+                  });
+                } else if (status === 401 || status === 403) {
+                  next({
+                    name: 'Login',
+                    replace: true,
+                  });
+                } else {
+                  // Cancel navigation on unexpected errors to avoid misreporting them as "not found"
+                  next(false);
+                }

-            const searchParams = new URLSearchParams({
-              name: to.params.name,
-              version: to.params.version,
+            const decodeParam = (value) => {
+              if (typeof value !== 'string') {
+                return '';
+              }
+              try {
+                return decodeURIComponent(value);
+              } catch (e) {
+                // If decoding fails (malformed escape sequences), fall back to the original value
+                return value;
+              }
+            };
+            const isValidSegment = (value) =>
+              typeof value === 'string' && !/[\\/]/.test(value);
+            const name = decodeParam(to.params.name);
+            const version = decodeParam(to.params.version);
+            if (!isValidSegment(name) || !isValidSegment(version)) {
+              next({
+                name: '404',
+                replace: true,
+              });
+              return;
+            }
+            const searchParams = new URLSearchParams({
+              name,
+              version,

Uh oh!

feat: Link to project using name and version #1425

Are you sure you want to change the base?

feat: Link to project using name and version #1425

Uh oh!

Conversation

WIStudent commented Jan 19, 2026

Description

Addressed Issue

Additional Details

projects/:name/:version/*

projects/:name/:version

Checklist

Uh oh!

owasp-dt-bot commented Jan 19, 2026

✅ Snyk checks have passed. No issues have been found so far.

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 19, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

`projects/:name/:version/*`

`projects/:name/:version`