Pass Astro version to Integrations

[feelixe]

Summary

I believe it would be good to pass the Astro version that is being used to one of the integration hooks.

Background & Motivation

• As an integration author you can throw errors or log warnings if the integration is being used in an unsupported version.
• You can adjust behaviour of your integration to "polyfill" features that are missing in older version of Astro.
• The workaround that I've used is to either check for existence of certain hook arguments or await import("astro/package.json", { with: { type: "json" } }), which I'm not sure is safe to use since it is experimental in node.

Goals

• Improve compatibility of Astro integrations.

[florian-lefebvre]

I'm very much in favor of this! I know we have the version available from inside astro so it should be available. Wanna make a PR?

[feelixe]

Sure, I'd love to make a PR. 🙂

[florian-lefebvre]

It's all yours then! Even if you don't have everything working, don't worry and submit a draft PR, I should be able to help you

[feelixe]

I've created a draft PR, withastro/astro#13116

[feelixe]

Though when writing it, it made me think it might be even better to simply export the astro version from the package, then you could return diffrent integrations depending on the version, and not have to wait for astro:config:setup to run. But there might be some reason you wouldn't want to export that.

[florian-lefebvre]

Thanks for the PR, I'll review it today. As for this idea, I think importing the package json should be fine?

import pkg from "astro/package.json" with { type: "json" }
import semver from "semver

export default function integration(options) {
	const v5 = semver(pkg.version, ">=5.0.0")
	return v5 ? v5integration(options) : v4integration(options)
}

[florian-lefebvre]

We've discussed it with other core members and the consensus is that we don't think this feature should live in Astro itself. However, I'm personally interested in it and would love to make it a feature of Astro Integration Kit! Feel free to open an issue https://github.com/florian-lefebvre/astro-integration-kit