Skip to main content

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.