# API Stability Policy

StormFetch uses semantic versioning.

- Patch releases fix defects without intentionally changing documented behavior.
- Minor releases may add exports, options, event types, and optional adapter capabilities while preserving existing calls.
- Major releases may remove deprecated APIs or change defaults after a migration guide and changelog entry are published.
- Root exports remain the compatibility surface. Focused subpath exports are stable public APIs from 1.14.0 onward.
- Type declarations, ESM imports, CommonJS imports, React Native imports, and the CLI are tested as publish surfaces.

Deprecations are documented in README, API_REFERENCE, CHANGELOG, and generated declarations for at least one minor release before removal, except when an immediate security response is required.

Internal files not reachable through `package.json#exports` are not public API.