vendure 2.9.0

vendure: ^2.9.0 copied to clipboard

• Fixed Enum Conversion for Conflicting Field Names: Enhanced normalizeGraphQLData to handle cases where multiple GraphQL types have fields with the same name (e.g., Parser.type, Order.type, Asset.type).
• Robust Fallback Mechanism: Added fallback logic that checks if a string value matches ANY known enum value from the introspection cache, ensuring all enums are converted even when field-to-type mappings conflict.
• Better Support for Custom Types: Custom plugin types with enum fields are now properly converted without requiring manual enum mapping.
• Non-Breaking Enhancement: The change is backward compatible and requires no API changes from consumers.

• Added global enum conversion toggles: VendureUtils.convertQueryEnums and VendureUtils.convertMutationEnums (both default to true).
• Added VendureUtils.setConvertEnums({bool? queryEnums, bool? mutationEnums}) helper to change conversion flags globally.
• normalizeGraphQLData and normalizeMutationData now respect global flags and also accept a per-call convertEnums override.
• Fixed mutation normalization to only convert actual enum fields using schema introspection (no heuristic conversions).
• Added per-call convertEnums parameter to CustomOperations mutation methods for fine-grained control.
• Exported VendureUtils from the package entrypoint so the global flags and helper are accessible to package consumers.
• Bumped package version to 2.8.0 in pubspec.yaml.
• Internal: improved safety around enum conversions and added tests for enum normalization behavior.

• BREAKING CHANGE: Removed default 10-second timeout for GraphQL queries
• Immediate Failure Detection: Connection failures now fail immediately instead of waiting for timeout
• Optional Timeout: The timeout parameter is now truly optional - only applies if explicitly set
• Improved User Experience: Apps can now detect unreachable backends instantly and proceed with fallback behavior

• Robust Enum Normalization: Refactored normalization to use dynamic schema introspection for all enum fields and values. Now supports automatic camelCase conversion for all enums, regardless of field name.
• Field-to-Enum Mapping: Added automatic mapping of GraphQL fields to their enum types using introspection, ensuring all enum fields are normalized.
• SDK Cleanup: Removed all debug prints, centralized normalization logic, and improved recursion for speed and maintainability.
• DRY & Fast: Refactored normalization to avoid duplicate logic and unnecessary recursion, making it production-grade and easy to extend.
• No Breaking Changes: All existing APIs remain compatible, but normalization is now more reliable and future-proof.

• Enhanced Language Code Support: Improved dynamic language code handling with proper URI parsing instead of string concatenation.
• Dynamic Channel Token Management: Added setChannelToken() and getChannelToken() methods for runtime channel switching.
• Better URI Handling: Fixed URI construction to properly handle existing query parameters and language codes in endpoints.
• New Static Methods: Added setLanguageCode(), getLanguageCode(), setChannelToken(), and getChannelToken() for dynamic configuration.
• Preserved Original Endpoints: When no language code is set, the original endpoint URL is preserved as-is without modification.
• Multi-tenant Support: Enhanced support for multi-channel applications with dynamic channel token switching.

• Updated graphql package to latest compatible version.
• Fixed async/generic bug in mutate for bool and map return types.
• Improved type safety and error handling for all custom operations.
• All previous bugfixes and enum normalization improvements included.

• Improved error handling for all Vendure error types (e.g. InvalidCredentialsError, ErrorResult, etc.) so authentication failures always throw a standardized, testable message.
• Defensive null checks for error messages to prevent type errors.
• Enum normalization restored: all enum values for keys in _vendureTypeEnums are now converted to Dart/camelCase style recursively.
• Type safety enforced for all map responses.
• Internal logging and debug improvements for error diagnosis.
• See normalizeGraphQLData and authentication methods for details.

• Added refresh token via Vendure instance: Vendure.instance.refreshToken(params) now available for direct use.
• Makes token refresh accessible from the singleton instance for all auth flows.

• Added refresh token support via TokenManager and Vendure.refreshToken.
• You can now refresh authentication tokens dynamically for long-lived sessions or custom auth flows.
• See Vendure.refreshToken and TokenManager for usage.

⚠️ Breaking Change #

• CustomOperations API: The fromJson parameter is now optional for mutate, query, queryList, and mutateList methods.
• If fromJson is not provided, the raw normalized data is returned (cast to the expected type).
• This change breaks previous usage where fromJson was required.
• Update your code to handle the new method signatures and return types.

• Added static setAuthToken method to update the authentication token on the initialized Vendure instance.

• added timeout option to Vendure initialization methods
• increased default GraphQL client timeout to 10 seconds (was 5 seconds)

• fixed enum value conversion in _convertEnumToDartFormat method
• improved handling of camelCase enum values (e.g., 'staticVal' now correctly preserved instead of being converted to 'staticval')
• method now properly handles both SCREAMING_SNAKE_CASE and camelCase enum formats

• fixed native authentication implementation
• improved GraphQL client configuration with better caching policies
• added default headers for HTTP requests
• enhanced guest session handling
• fixed typo in available countries query filename
• added comprehensive test suites for user journeys

• added support for vendure-token header to pass the channel
• added languageCode support for translations

• added mutateList for mutations that return a List

• refactored custom operations code

• changed fromJson data type to dynamic

• fixed customfields config not passing to order and system operations

• fixed internal type import

• fixed ActiveCustomer error on active order removeAllItems

• fixed Customer customFields parsing issue

• fixed Turkish Lira TRY conversion issue

• Removed CollectionWithParentChildren entity

• Added getCollectionsWithParentChildren method
• Added getCollectionWithChildren method
• Added getCollectionWithParent method
• Added getCollectionWithParentChildren method
• Updated FacetValue to includ Facet

• Added support for customfields. define customfieldsConfig on initialize

• Updated productId and productVariantId int types to String

• Renamed type to CollectionWithParentChildren for simplicity

• Added getCollectionsWithParentChildren method

• fixed the bug options not passing on getCollections

• changed getCollectionById tpe to String from int

• changed getOrderByCode return type to Order

• updated http dependency

• Added setOrderShippingMethod example

• Strong types are implemented for all methods

• All shop-api methods are implemented

• Updated README

• Added setOrderShippingAddress method
• Added getActiveOrder method
• Added addPaymentToOrder method
• Added getOrderByCode method
• Added getPaymentMethods method
• Added getShippingMethods method
• Added setCustomerForOrder method

• Added setOrderShippingAddress and updated README example

• Exported types

• Updated Readme explaining how to manage firebase token changes

• Update the instance credentials without reinitizialize

• Made it singleton with predefined initialization methods NativeAuth,FirebaseAuth,Token and Custom Auth

• fixed http dependency

• Added automated opinionated session refresh management

• Added extractResponseHeaders method to extract response headers.

• Initial version.