feat: client perma cache

[vasco-santos]

This PR adds perma-cache client to client package. There are potential improvements on the pipeline (like converting given URLs to nftstorage.link if they are IPFS urls), but keeping scope smaller for initial implementation.

It includes:

• all 4 initial methods (put, delete, list, status)
  • Support for batching, retries, and rate limit control as needed
• smoke tests with mock API (we can move on later to spin up the actual API + DB + Gateway)
• workflow tests updated to run bundlesize and pre mocking
• client docs separated between scopes, one (unchanged) Markdown file for gateway utils and other for perma cache docs.

Closes #92

BREAKING CHANGE: GET /perma-cache/status renamed to /perma-cache/account

[cloudflare-pages[bot]]

Deploying with    Cloudflare Pages

Latest commit:	57aaece
Status:	✅  Deploy successful!
Preview URL:	https://5536a151.nftstorage-link.pages.dev
Branch Preview URL:	https://feat-client-perma-cache.nftstorage-link.pages.dev

View logs

[vasco-santos]

@alanshaw renamed API route as you suggest, we are still in private beta. Thinking if we should keep /perma-cache/status for now as deprecated, or just get it out right away. What do you think?

[alanshaw]

@alanshaw renamed API route as you suggest, we are still in private beta. Thinking if we should keep /perma-cache/status for now as deprecated, or just get it out right away. What do you think?

It's the same response right? I'd maybe just stick a redirect in for now...