# Spoosh

> Spoosh is a type-safe API client with a powerful plugin system. Define your API schema once and get full TypeScript autocomplete everywhere.

## Docs

- [Full Docs](https://spoosh.dev/llms-full): Full documentation of all features and plugins.

## Getting Started

- [Overview](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/getting-started/index.mdx): Getting started overview
- [Installation](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/getting-started/installation.mdx): Install and setup Spoosh
- [First API Call](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/getting-started/first-api-call.mdx): Make your first API call

## Core

- [Overview](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/core/index.mdx): Core concepts overview
- [Client](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/core/client.mdx): Creating and configuring clients
- [Schema Definition](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/core/schema-definition.mdx): Define your API schema
- [Response](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/core/response.mdx): Response format and handling

## Plugins

- [Overview](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/index.mdx): Plugin system overview

### Data Fetching
- [Cache](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/cache.mdx): In-memory caching with stale-while-revalidate
- [Deduplication](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/deduplication.mdx): Prevent duplicate concurrent requests
- [Prefetch](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/prefetch.mdx): Preload data before navigation
- [Initial Data](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/initial-data.mdx): SSR hydration support

### Mutations
- [Invalidation](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/invalidation.mdx): Auto-refresh queries after mutations
- [Optimistic](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/optimistic.mdx): Optimistic updates for instant UI feedback

### Resilience
- [Retry](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/retry.mdx): Automatic retry with exponential backoff
- [Throttle](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/throttle.mdx): Rate limiting for API calls
- [Debounce](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/debounce.mdx): Debounce rapid requests

### Real-time
- [Polling](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/polling.mdx): Periodic data refresh
- [Refetch](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/refetch.mdx): Refetch on window focus or reconnect

### Framework Integration
- [Next.js](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/nextjs.mdx): Server-side cache revalidation

### Developer Tools
- [Debug](https://raw.githubusercontent.com/nxnom/spoosh/main/docs/content/docs/plugins/debug.mdx): Debug logging for development