@photonite/subgraph-sync/CHANGELOG.md

React hooks and components for tracking subgraph synchronization states with Apollo Client

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2025-11-17

### Added

- Initial release of subgraph-sync library
- `useSubgraphSync` hook for tracking synchronization state
- `useSubgraphQuery` hook combining Apollo queries with sync tracking
- `SyncIndicator` component for displaying sync progress
- Full TypeScript support with comprehensive type definitions
- Automatic retry logic with configurable max retries
- Timeout handling with callbacks
- Progress calculation (0-100%)
- Block number and timestamp targeting
- 54 comprehensive tests with 96%+ coverage
- Complete documentation and examples

### Features

- Real-time subgraph indexing progress tracking
- Configurable polling intervals
- Error handling with callbacks
- Sync completion callbacks
- Manual refetch capability
- State reset functionality
- Pre-built UI components

### Developer Experience

- Full JSDoc documentation
- TypeScript definitions included
- Comprehensive README with examples
- Test suite with high coverage
- Clean modular architecture

## [Unreleased]

### Planned

- Additional UI component variants
- Performance optimizations
- Extended configuration options
- Additional utility hooks