astro/dist/core/fetch/features.js

Astro is a modern site builder with web best practices, performance, and DX front-of-mind.

/**
* Bit flags for features that handler functions register as "used" when a
* custom `src/fetch.ts` fetch handler is in play. After the first request
* (dev) or at runtime (prod SSR), we compare against the manifest to warn
* about features the user configured but forgot to include in their custom
* fetch handler.
*/
export const FetchFeatures = {
	redirects: 1 << 0,
	sessions: 1 << 1,
	actions: 1 << 2,
	middleware: 1 << 3,
	i18n: 1 << 4,
	cache: 1 << 5
};
/** All feature bits ORed together. Keep next to `FetchFeatures` so
*  new flags are hard to forget. */
export const ALL_FETCH_FEATURES = FetchFeatures.redirects | FetchFeatures.sessions | FetchFeatures.actions | FetchFeatures.middleware | FetchFeatures.i18n | FetchFeatures.cache;
// Scoped per manifest: two Apps constructed over the same manifest object
// (e.g. the cloudflare custom-fetch worker) share this bitmask — the bits
// accumulate from the same renders the warning already observed.
const usedFeatures = new WeakMap();
/** ORs a feature bit into the manifest's used-features bitmask. */
export function markFeatureUsed(manifest, feature) {
	const entry = usedFeatures.get(manifest);
	if (entry) {
		entry.bits |= feature;
	} else {
		usedFeatures.set(manifest, { bits: feature });
	}
}
/** The used-features bitmask for a manifest; `0` when nothing was marked. */
export function getUsedFeatures(manifest) {
	return usedFeatures.get(manifest)?.bits ?? 0;
}