static-paths.ts — astro Source File

Source Code

import type { SSRManifest } from '../../core/app/types.js';
import type { Pipeline } from '../../core/base-pipeline.js';
import type { PathWithRoute } from '../../types/public/integrations.js';
import type { RouteData } from '../../types/public/internal.js';
import { stringifyParams } from '../../core/routing/params.js';
import { routeIsRedirect, routeIsFallback, getFallbackRoute } from '../../core/routing/helpers.js';
import { callGetStaticPaths } from '../../core/render/route-cache.js';

export type { PathWithRoute } from '../../types/public/integrations.js';

/**
 * Minimal interface for what StaticPaths needs from an App.
 * This allows adapters to pass any App-like object (BuildApp, NodeApp, etc).
 */
export interface StaticPathsApp {
	manifest: SSRManifest;
	pipeline: Pick<Pipeline, 'routeCache' | 'getComponentByRoute'>;
}

/**
 * Collects all static paths for prerendering.
 * Handles calling getStaticPaths on each route and populating the route cache.
 */
export class StaticPaths {
	#app: StaticPathsApp;

	constructor(app: StaticPathsApp) {
		this.#app = app;
	}

	/**
	 * Get all static paths for prerendering with their associated routes.
	 * This avoids needing to re-match routes later, which can be incorrect due to route priority.
	 */
	async getAll(): Promise<PathWithRoute[]> {
		const allPaths: PathWithRoute[] = [];
		const manifest = this.#app.manifest;

		// Collect routes to generate (mirrors retrieveRoutesToGenerate)
		const routesToGenerate: RouteData[] = [];
		for (const { routeData } of manifest.routes) {
			// Skip non-prerendered routes
			if (!routeData.prerender) continue;

			// Include redirects
			if (routeIsRedirect(routeData)) {
				routesToGenerate.push(routeData);
				continue;
			}

			// Include fallbacks if i18n has fallback configured
			if (routeIsFallback(routeData) && manifest.i18n?.fallback) {
				routesToGenerate.push(routeData);
				continue;
			}

			// Regular page
			routesToGenerate.push(routeData);
		}

// ... (70 more lines)