Roadmap
parcely is structured as a monorepo. Some addon packages have shipped; others are reserved for future development.
Shipped addon packages
@parcely/retry
Exponential-backoff retries with full jitter, Retry-After honoring, AbortSignal-aware backoff sleep, and idempotent-methods-by-default safety.
Status: Shipped (0.1.0). See the retries guide and @parcely/retry reference.
@parcely/auth-token
Bearer / API-key / Basic token interceptor with single-flight refresh-on-401.
Status: Shipped (0.1.0). See the @parcely/auth-token reference.
@parcely/auth-redirect
Browser 401/403 → login redirect interceptor with return_to preservation and cooldown debounce.
Status: Shipped (0.1.0). See the @parcely/auth-redirect reference.
In progress
@parcely/react
React hooks (useQuery, useSuspenseQuery, useMutation) and a TanStack Query adapter.
Status: In development.
Reserved subpackage slots
@parcely/upload-node
Node-specific upload utilities: file-path convenience helpers (uploadFile('./big.zip')), chunked uploads, and resumable upload support.
Status: Planned. In the meantime, see the Node ReadStream upload guide for streaming uploads from disk.
Future considerations
- Host allowlists/blocklists for additional SSRF protection
- Request/response size limits
- mTLS / client certificate support
- Minimum TLS version configuration
- SWR adapter (
@parcely/react/swr)
Contributing
If you are interested in contributing to any of these areas, please open an issue to discuss the design before submitting a pull request.