@dev-fastn-ai/react-core 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,78 @@
+# 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] - 2024-01-XX
+
+### Added
+- Initial release of @fastn-ai/react-core
+- React hooks and components for Fastn AI integration
+- Built on top of @fastn-ai/core with React Query
+- FastnProvider for React application setup
+- useConnectors hook for fetching marketplace connectors
+- useConfigurations hook for managing connector configurations
+- useConfigurationForm hook for dynamic form handling
+- useFieldOptions hook for async select field options
+- Complete TypeScript support with full type exports
+- React Query integration for caching and performance
+- Comprehensive error handling and loading states
+- Optimistic updates and background refetching
+
+### Features
+- `FastnProvider` component for application setup
+- `useConnectors()` hook with React Query caching
+- `useConfigurations()` hook for configuration management
+- `useConfigurationForm()` hook for form handling
+- `useFieldOptions()` hook for async select fields
+- Full TypeScript support with exported types
+- React Query integration for optimal performance
+- Error boundaries and loading state management
+
+### Hooks
+- `useConnectors` - Fetch and manage marketplace connectors
+- `useConfigurations` - Handle connector configurations
+- `useConfigurationForm` - Manage dynamic configuration forms
+- `useFieldOptions` - Async select field options with search/pagination
+
+### Components
+- `FastnProvider` - Main provider component with configuration
+- Context provider for Fastn client access
+- React Query provider integration
+
+### Types
+- All types from @fastn-ai/core exported
+- React-specific type definitions
+- Hook return type definitions
+- Component prop type definitions
+
+### Performance
+- React Query integration for intelligent caching
+- Background refetching and stale data management
+- Optimistic updates for better UX
+- Automatic retry on failure
+- Cache invalidation and garbage collection
+
+### Developer Experience
+- Complete TypeScript support
+- Comprehensive documentation with examples
+- Error handling with custom error classes
+- Loading states and skeleton components
+- Best practices and troubleshooting guides
+
+---
+
+## [Unreleased]
+
+### Planned
+- Additional React components for common UI patterns
+- Form validation integration
+- Advanced caching strategies
+- Real-time updates with WebSocket support
+- Performance optimizations
+- Additional hook utilities
+- Testing utilities and examples
+- Storybook integration
+- Advanced error recovery mechanisms 

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Fastn AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.