tvf_flutter_graphql 1.1.2

GraphQL Query Examples Reference for Mobile App (Flutter/Dart). This is a reference package only - DO NOT install. Browse source code to copy GraphQL query strings for mobile endpoints.

Changelog

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

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.2 2025-01-XX

Changed

• Updated to focus on 4 core mobile endpoints
• Removed: getFirmwares query
• Updated: 3 queries + 1 mutation:
  • getUser - Get user with nested devices (query)
  • getAppSettings - Get app settings from user (query)
  • getAlerts - Get alerts for user (query)
  • createDeviceToken - Create device token for push notifications (mutation)
• Each endpoint includes complete Flutter usage examples with proper syntax
• Updated README with all 4 endpoints

1.2.0 2025-01-XX

Changed

• BREAKING: Complete restructure - now focuses on mobile app endpoints only
• Removed: All previous queries and mutations
• Added: 4 mobile-specific queries:
  • getUser - Get user with nested devices
  • getAppSettings - Get app settings from user
  • getAlerts - Get alerts for user
  • getFirmwares - Get firmware list
• Each query includes complete Flutter usage examples with proper syntax
• Updated README with mobile-focused examples

1.1.1 2025-01-XX

Fixed

• Removed helper files that required Flutter/Amplify dependencies (graphql_client.dart, push_command_helper.dart, push_notification_helper.dart)
• Removed model files (not needed for reference package)
• Package now contains only GraphQL query/mutation examples with no dependencies

1.1.0 2025-01-XX

Changed

• BREAKING: Package renamed from tvf_flutter_schema to tvf_flutter_graphql
• BREAKING: Package is now a REFERENCE ONLY - DO NOT install in your app
  • Removed all dependencies (flutter, graphql, amplify, etc.)
  • Package now serves as documentation/reference only
  • Browse source code to copy GraphQL query/mutation strings
  • No installation needed - just copy the strings into your app
• Added getUserCount query example (see next/app/components/Counter.tsx line 170-174)
• Updated README with clear instructions: browse source code, copy strings, use directly
• Removed all references to "KOMBU" from package

Migration Guide

If you're upgrading from tvf_flutter_schema:

1. Update pubspec.yaml:

   dependencies:
     tvf_flutter_graphql:
       path: ../packages/flutter-schema  # or git URL
   

2. Update imports:

   // Old
   import 'package:tvf_flutter_schema/tvf_flutter_schema.dart';
      
   // New
   import 'package:tvf_flutter_graphql/tvf_flutter_graphql.dart';
   

3. Use examples directly:

   // Copy query/mutation strings from the package
   final query = UserQueries.getUser;
      
   // Use with your own GraphQL client
   final result = await yourGraphQLClient.query(
     document: query,
     variables: {'id': userId},
   );
   

Notes

• This package now serves as a reference for GraphQL operations
• Copy the query/mutation strings and use them with your preferred GraphQL client
• No model classes or client implementation included - examples only

---

1.3.0 2025-01-XX (kombu_flutter_schema)

Added

• DeviceUserMapping model - Junction table for many-to-many relationship between User and Device
  • Supports: 1 user can connect to many devices
  • Supports: 1 device can allow many users to connect
• DeviceUserMappingQueries - GraphQL queries for device-user mappings:
  • getDeviceUserMapping - Get mapping by ID
  • usersByDevice - Query all users for a device
  • devicesByUser - Query all devices for a user
  • mappingByDeviceAndUser - Check if user has access to device
  • listDeviceUserMappings - List all mappings
• DeviceUserMappingMutations - GraphQL mutations for device-user mappings:
  • createDeviceUserMapping - Add user to device
  • updateDeviceUserMapping - Update user role or mapping details
  • deleteDeviceUserMapping - Remove user from device

Changed

• Updated main export file to include DeviceUserMapping model, queries, and mutations
• Version bumped to 1.3.0 (minor version for new feature)

Notes

• DeviceUserMapping enables shared device access with role-based permissions
• Backward compatibility: Device.userId and User.devices still work for owned devices
• Use DeviceUserMapping for multi-user device sharing scenarios

1.2.3 - 2025-11-27

Changed

• README.md: Reordered Device Token Registration options
  • Direct GraphQL Mutations is now Option 1 (recommended for full control)
  • Auto Register moved to Option 2
  • Manual Create/Update moved to Option 3
• Updated documentation to prioritize direct GraphQL mutations usage

1.2.2 - 2025-11-25

Added

• Public methods in PushNotificationHelper:
  • createDeviceToken() - Public method to create device token directly
  • updateDeviceToken() - Public method to update device token directly
• Improved documentation for device token management with multiple usage options

Updated

• PushNotificationHelper.registerDeviceToken() - Now includes better documentation explaining it uses built-in Amplify mutations
• _createDeviceToken() and _updateDeviceToken() - Now support appVersion parameter
• README.md - Added comprehensive examples for device token management (auto register, manual create/update, direct GraphQL)

Notes

• All device token operations use built-in Amplify Gen 2 mutations:
  • DeviceTokenMutations.createDeviceToken
  • DeviceTokenMutations.updateDeviceToken
  • DeviceTokenMutations.deleteDeviceToken
• No custom mutations needed - Amplify automatically generates these from the schema

1.2.1 - 2025-11-25

Updated

• Updated CHANGELOG.md with correct date for version 1.2.0

[1.2.0] - 2025-11-25

Added

• createDevice mutation - Create new device in the system
• pushCommand mutation - Push commands to AWS IoT Core topics via MQTT
• PushCommandHelper class - Helper methods for pushing commands (with automatic payload stringification)
• latestFirmwareVersion field - Added to Device model for KPI tracking and firmware comparison
• deactivateUser mutation - Deactivate user (custom mutation)
• reactivateUser mutation - Reactivate user (custom mutation)
• removeUser mutation - Remove user permanently (custom mutation)

Changed

• Updated Device model to include latestFirmwareVersion field
• Updated Device queries to include latestFirmwareVersion field
• Updated Device mutations to include latestFirmwareVersion field

[1.1.0] - 2025-01-15

Added

• Notification model with queries and mutations for mobile app
• DeviceToken model for push notification device token management
• Device queries and mutations for mobile app device management
• PushNotificationHelper class for easy device token registration
• Mobile-focused API documentation and examples

Changed

• Refactored to mobile-focused: Only includes APIs relevant to mobile app
• Removed admin-only operations (createUser, deleteUser, listUsers)
• Updated User queries to only include getUser (mobile typically gets own user)
• Updated User mutations to only include updateUser (user creation via Cognito)
• Improved README with mobile-focused examples and usage

Removed

• User createUser, deleteUser, listUsers mutations/queries (admin-only)
• DeviceTelemetry (use MQTT for real-time data)
• DeviceConfiguration (backend/internal only)

1.0.1 - 2025-11-08

Changed

• Updated README.md to use amplify_flutter instead of graphql_flutter
• Updated all code examples to use AWS Amplify Flutter API
• Improved documentation with complete API examples

Updated

• All queries now use ModelQueries with Amplify.API.query()
• All mutations now use ModelMutations with Amplify.API.mutate()
• All subscriptions now use ModelSubscriptions with Amplify.API.onSubscription()
• Error handling updated to use ApiException

1.0.0 - 2025-11-07 (kombu_flutter_schema)

Added

• Initial release of kombu_flutter_schema (now renamed to tvf_flutter_schema)
• User model with JSON serialization
• Device model with JSON serialization
• GraphQL queries for User (getUser, listUsers)
• GraphQL mutations for User (createUser, updateUser, deleteUser)
• Support for Flutter/Dart GraphQL clients