fix: add stub for getLiveCollection in non-live contexts (#14109)

ascorbic · web-flow · commit 5a08fa22b402 · 2025-07-22T17:01:37.000+01:00
diff --git a/.changeset/major-games-thank.md b/.changeset/major-games-thank.md
@@ -0,0 +1,5 @@
+---
+'astro': patch
+---
+
+Throw a more helpful error if defineLiveCollection is used outside of a live.config file
diff --git a/packages/astro/src/content/runtime.ts b/packages/astro/src/content/runtime.ts
@@ -974,3 +974,12 @@ export function defineCollection(config: any) {
 	}
 	return defineCollectionOrig(config);
 }
+
+export function defineLiveCollection() {
+	throw new AstroError({
+		...AstroErrorData.LiveContentConfigError,
+		message: AstroErrorData.LiveContentConfigError.message(
+			'Live collections must be defined in a `src/live.config.ts` file.',
+		),
+	});
+}
diff --git a/packages/astro/templates/content/module.mjs b/packages/astro/templates/content/module.mjs
@@ -11,7 +11,7 @@ import {
 	createReference,
 } from 'astro/content/runtime';
 
-export { defineCollection, renderEntry as render } from 'astro/content/runtime';
+export { defineCollection, defineLiveCollection, renderEntry as render } from 'astro/content/runtime';
 export { z } from 'astro/zod';
 
 /* @@LIVE_CONTENT_CONFIG@@ */

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'astro': patch
 +---
++
 +Throw a more helpful error if defineLiveCollection is used outside of a live.config file
Original file line number	Diff line number	Diff line change
`@@ -974,3 +974,12 @@ export function defineCollection(config: any) {`
`974`	`974`	`}`
`975`	`975`	`return defineCollectionOrig(config);`
`976`	`976`	`}`
	`977`	`+`
	`978`	`+export function defineLiveCollection() {`
	`979`	`+ throw new AstroError({`
	`980`	`+ ...AstroErrorData.LiveContentConfigError,`
	`981`	`+ message: AstroErrorData.LiveContentConfigError.message(`
	`982`	+ 'Live collections must be defined in a `src/live.config.ts` file.',
	`983`	`+ ),`
	`984`	`+ });`
	`985`	`+}`