Deprecation notices, migration guide and existing queries.

[scottdixon]

• Publishes migration guide and existing queries.

• Adds deprecation notice to docs:

• Adds deprecation notice to readme:

[johndwells]

Can I ask, is this the direction this library is taking, is it actually being deprecated?

Because we've also found this branch: sd-cart, which migrates to use the new Cart API. We've been testing this branch and have found it works well, though we did submit a pull request last week that adds some missing info about the underlying product of a line item.

So which is it, is this library being abandoned, or can we expect it to continue to be maintained and kept up to date with the latest API changes?

We love this library and really hope it sticks around!

[thipokch]

I just started using this library and was caught off guard by the lack of a deprecation notice, which I ended up wasting a lot of time. The value proposition by Storefront API Client is pretty minimal, it's basically a graphql client. Please help me understand the context or why this decision was made by Shopify, thank you.

@johndwells Do you think it might be worth considering a community-maintained fork?

[johndwells]

@thipokch It would be a shame to see this library lose 1st party support. I wish we could commit resources to lead the community in maintaining this, but we'd be overstretching ourselves, and besides there is a lot of tooling in this repo that I'm not familiar with.

For ourselves, we've already abandoned the library all-together, and re-wrote our own JS to speak directly to the Storefront API. If the community does rally to save the library, we'd happy return and contribute if we can.