feat: support environments in @slicemachine/plugin-kit, @slicemachine/manager, and adapters (DT-1650, DT-1721)

[angeloashmore]

Important

This PR is based on #1160.

Context

DT-1650, DT-1721

The Solution

• Add two new hooks:
  • project:environment:read
  • project:environment:update
• Add two new manager methods:
  • manager.project.readEnvironment()
  • manager.project.updateEnvironment()
• Add two new @slicemachine/plugin-kit/fs helpers:
  • readProjectEnvironment()
  • writeProjectEnvironment()
• Implement the new hooks in the adapters:
  • @slicemachine/adapter-next
  • @slicemachine/adapter-nuxt
  • @slicemachine/adapter-nuxt2
  • @slicemachine/adapter-sveltekit

Impact / Dependencies

This work will coincide with work on the Slice Machine API.

Checklist before requesting a review

• I hereby declare my code ready for review.
• If it is a critical feature, I have added tests.
• The CI is successful.
• If there could backward compatibility issues, it has been discussed and planned.

[linear]

DT-1650 [manager] AAUser, I want to update my framework-specific .env file, with a Prismic environment value

[TBD angeloashmore]

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
slice-machine	✅ Ready (Inspect)	Visit Preview	Nov 17, 2023 1:11am

[lihbr]

Just a pre-review, but it looks good to me so far :)

For Nuxt it'll be able to work similarly, the environment variable will be: NUXT_PUBLIC_PRISMIC_ENDPOINT

Happy to do it, but if you want to give it a shot, sure thing!

As you said, it'll be nice to abstract the env-reading utils to plugin-kit/fs

[linear]

DT-1721 AADev, I want to use correct types for environments list

After review with platform, we ended up with this structure for environments:

{
    "results": [{
        "kind": "prod",
        "name": "my-test-repo-env",
        "domain": "my-test-repo-env",
        "users": [{ "id": "XxBvdxEAABoAvQ2j" }]
    }, {
        "kind": "stage",
        "name": "Staging",
        "domain": "my-test-repo-env-staging",
        "users": [{ "id": "XxBvdxEAABoAvQ2j" }, { "id": "Xx12UIxhe6WEiOs14" }]
    }]
}

Code that relies on them should be updated accordingly

[lihbr]

LGTM, really nice work!

[angeloashmore]

Will be merged into a separate PR.