feat: rename API package to @netlify/api

[eduardoboucas]

Summary

Starts publishing the API client as @netlify/api so that we can repurpose the netlify package for the CLI.

[github-actions]

This pull request adds or modifies JavaScript (.js, .cjs, .mjs) files.
Consider converting them to TypeScript.

[github-actions]

This pull request adds or modifies JavaScript (.js, .cjs, .mjs) files.
Consider converting them to TypeScript.

[github-actions]

This pull request adds or modifies JavaScript (.js, .cjs, .mjs) files.
Consider converting them to TypeScript.

[pieh]

Starts publishing the API client as @netlify/api so that we can repurpose the netlify package for the CLI.

Is there a plan for how the package name swap will be done? If we want to use netlify package for CLI which up until this change was for API client I can see this causing confusion.

Do we know how to instruct various dependency bumper (dependabot, renovate, etc) to swap package names appropriately so those could automatically do package name swap? For packages we control doing this manually I think is fine even if a bit busy work, but for external consumers this whole thing might cause confusion and potentially problems for them to deal with?

For example for renovate https://docs.renovatebot.com/configuration-options/#replacementname and there is example for when Vercel rebranded from Now ( https://github.com/renovatebot/renovate/blob/866cdb391b78f368ea7c6c9baf62e36343fce2e6/lib/data/replacements.json#L767-L778 ), but I'm not very familiar if there is something potentially more automatic that could just apply to all dependency managers like that

---edit
We might decide to not do anything about it - and that's fine I guess, I just want to make sure this was thought through and not have oopsie later

[eduardoboucas]

@pieh My plan is to keep exporting the same API interface from the new netlify package, so technically it will continue to work in the same way. The main consequence going forward is that the package will get much larger, because it will now contain the whole CLI.

We'll cut a new major and in the change log explain that they should change to @netlify/api.

[serhalp]

LGTM

[github-actions]

This pull request adds or modifies JavaScript (.js, .cjs, .mjs) files.
Consider converting them to TypeScript.