Add test to cover longest URL match for nested site spaces

README.md

@@ -161,4 +161,4 @@ GitBook wouldn't be possible without these projects:
 
 ## Legacy GitBook (Deprecated)
 
-Our previous version of GitBook and it's CLI tool are now deprecated. You can still view the old repository and it's commits on this [branch](https://github.com/GitbookIO/gitbook/tree/legacy).
+Our previous version of GitBook and it's CLI tool are now deprecated. You can still view the old repository and it's commits on this [branch](https://github.com/GitbookIO/gitbook/tree/legacy).

packages/gitbook/src/lib/sites.test.ts

@@ -14,6 +14,7 @@ import { createLinker } from './links';
 import {
     filterSiteSpacesByLocale,
     findSiteSpaceBy,
+    findSiteSpaceByUrl,
     getFallbackSiteSpacePath,
     getLinkerForSiteSpace,
     getSiteStructureSections,
@@ -114,6 +115,30 @@ describe('site structure traversal', () => {
     });
 });
 
+describe('findSiteSpaceByUrl', () => {
+    const docsSpace = {
+        id: 'docs',
+        urls: { published: 'https://example.com/docs' },
+    } as SiteSpace;
+    const v2Space = {
+        id: 'v2',
+        urls: { published: 'https://example.com/docs/v2' },
+    } as SiteSpace;
+
+    it.each([
+        { order: 'broader space first', spaces: [docsSpace, v2Space] },
+        { order: 'nested space first', spaces: [v2Space, docsSpace] },
+    ])('chooses the longest matching published URL with $order', ({ spaces }) => {
+        const match = findSiteSpaceByUrl(
+            { type: 'siteSpaces', structure: spaces },
+            'https://example.com/docs/v2/install'
+        );
+
+        expect(match?.siteSpace).toBe(v2Space);
+        expect(match?.pagePath).toBe('install');
+    });
+});
+
 describe('filterSiteSpacesByLocale', () => {
     it('returns all spaces on a single-language site', () => {
         const spaces = [makeSiteSpace(undefined), makeSiteSpace(undefined)];