UnknownContentCollectionError when Soft Links Used in Content Collections

[equt]

Astro info

Astro version            v2.10.14
Package manager          npm
Platform                 darwin
Architecture             arm64
Adapter                  Couldn't determine.
Integrations             None or couldn't determine.

What browser are you using?

Chrome

Describe the Bug

1. Create a collection, either in data or in content
2. Soft link files or entire directory into the src/content directory
3. Query that collection

What's the expected result?

It should work as normal

Link to Minimal Reproducible Example

https://stackblitz.com/edit/github-x2fbkv?file=src%2Fpages%2Findex.astro&on=stackblitz

Participation

• I am willing to submit a pull request for this issue.

[equt]

I can't figure out a way to create a real soft link in the above reproducible sandbox. But the problem is caused by the

astro/packages/astro/src/content/utils.ts

Lines 182 to 197 in 04fa5a1

	export function getEntryCollectionName({
	contentDir,
	entry,
	}: Pick<ContentPaths, 'contentDir'> & { entry: string | URL }) {
	const entryPath = typeof entry === 'string' ? entry : fileURLToPath(entry);
	const rawRelativePath = path.relative(fileURLToPath(contentDir), entryPath);
	const collectionName = path.dirname(rawRelativePath).split(path.sep)[0];
	const isOutsideCollection =
	!collectionName || collectionName === '' || collectionName === '..' || collectionName === '.';
	if (isOutsideCollection) {
	return undefined;
	}
	return collectionName;
	}

This utility function will parse the collection name out of the entry, which comes from the fileId. Unfortunately, Vite will resolve the (link) path before Astro ever has a chance to read the it.

[natemoo-re]

Yep, this makes sense and it seems like we should support it! Probably didn't account for symlinks.

[YonicDev]

While tackling this I found out that there's an option for Vite to preserve soft links when resolving.
Add the following config in astro.config.mjs and it should work:

export default defineConfig({
  vite: {
    resolve: {
      preserveSymlinks: true
    }
  }
})