json_son 0.5.0

json_son: ^0.5.0 copied to clipboard

New Type Parsers #

• Added flexibleEnumFromJson<T> for parsing strings/ints to enum values with fallback support
• Added flexibleBigIntFromJson for handling large integers that overflow int64
• Added flexibleDurationFromJson supporting:
  • ISO 8601 format (e.g., "PT1H30M", "P1D")
  • Human-readable format (e.g., "1h 30m", "2d 5h", "90s", "500ms")
  • Map with duration components (e.g., {"hours": 2, "minutes": 30})
  • Integer milliseconds

String Utilities #

• Added flexiblePhoneFromJson for normalizing phone numbers
• Added flexibleSlugFromJson for converting strings to URL-safe slugs
• Added flexibleCurrencyFromJson with CurrencyValue class for parsing currency formats

JsonSon Class Enhancements #

• Added new type getters: getDuration, getBigInt, getCurrency, getEnum, getPhone, getSlug
• Added path-based list access: getListPath<T>, getListPathOrEmpty<T>
• Added path-based getters: getDurationPath, getBigIntPath

Advanced Object Operations #

• Added deepMerge for recursively merging nested objects
• Added diff for comparing two JsonSon objects (returns added, removed, changed)
• Added pick for selecting values at nested paths (like select but with dot notation)
• Added flatten and unflatten for converting between nested and dot-notation formats

Conditional Getters & Utilities #

• Added conditional getters: getIf<T>, getIntIf, getStringIf
• Added toQueryString for converting JsonSon to URL query parameters

Validator Enhancements #

• Added format validators: phone, uuid, creditCard
• Added date validators: dateRange, pastDate, futureDate
• Added conditional validators: when, requiredWhen, requiredWith, requiredWithout
• Added array validators: unique, minItems, maxItems
• Added comparison validators: between, equals, different
• Added string validators: contains, startsWith, endsWith

• Added copyWith methods to helper classes:
  • PaginationInfo.copyWith
  • ApiError.copyWith
  • UserInfo.copyWith
  • TimestampInfo.copyWith
• Enables immutable updates for all data classes

• Added == and hashCode operators to data classes:
  • JsonSon
  • PaginationInfo
  • ApiError
  • UserInfo
  • TimestampInfo
• Improves testability and enables use in collections like Set and Map keys

Breaking Changes #

• BREAKING: Changed flexibleListFromJson return type from List<T?>? to List<T>?
  • The function already filtered out null values, so the return type now accurately reflects this
  • Migration: Update type annotations from List<T?>? to List<T>?
• Updated JsonSon.getList method to match the new signature
• Simplified JsonSon.getObjectList implementation

• Added missing OrDefault methods to JsonSon class:
  • getDateTimeOrDefault(String key, DateTime defaultValue)
  • getUriOrDefault(String key, Uri defaultValue)
  • getDateTimePathOrDefault(String path, DateTime defaultValue)
  • getUriPathOrDefault(String path, Uri defaultValue)
• Completes the OrDefault method set for all supported types

• Enhanced flexibleDateTimeFromJson with automatic seconds vs milliseconds detection:
  • Values < 10 billion are treated as seconds since epoch (Unix timestamp)
  • Values >= 10 billion are treated as milliseconds since epoch
  • Improves compatibility with APIs that use Unix timestamps in seconds

• Internal refactor: removed duplicate function implementations from json_son.dart
• Functions are now only defined in json_son_base.dart and properly re-exported
• No functional changes

• Added comprehensive tests for all new features

• Added non-nullable versions of flexible functions that return default values instead of null:
• flexibleRequiredBoolFromJson: Returns false if null
• flexibleRequiredListFromJson: Returns empty list if null (alias for flexibleListNotNullFromJson)

• Added non-nullable versions of flexible functions that return default values instead of null:
  • flexibleRequiredIntFromJson: Returns 0 if null
  • flexibleRequiredDoubleFromJson: Returns 0.0 if null
  • flexibleRequiredStringFromJson: Returns empty string if null

• Ran dart format on the codebase

• Fixed documentation comments to properly escape angle brackets in type references

Enhanced JsonSon Class #

• Added error tracking with detailed path information for debugging and validation
• Implemented advanced constructors for different data sources:
  • fromApiResponse: Handle API responses that might be strings or maps
  • fromMapSafe: Safely create JsonSon instances with error handling
• Added batch operations for processing multiple keys or paths at once
• Implemented fallback keys to try multiple keys in sequence until a value is found
• Added transformation methods for mapping and merging JSON data
• Implemented validation methods for checking required keys and paths

Extensions #

• Created JsonSonMapExtension for direct access to JsonSon methods from Map objects
• Developed JsonSonApiExtension for common API patterns including:
  • Pagination information extraction
  • Error handling with code and message extraction
  • User information normalization
  • Timestamp handling

Validation Framework #

• Implemented JsonSonValidator with a fluent API for complex validation logic
• Added type validation for strings, integers, booleans, etc.
• Added format validation for emails, URLs, and custom patterns
• Implemented range validation for numeric values and string lengths
• Added support for custom validation rules
• Added nested validation for objects and array items

Testing #

• Added comprehensive test suite for all new features
• Created tests for extensions and the validation framework
• Ensured all tests pass with proper error handling

Documentation #

• Updated README with detailed examples and API documentation
• Added code examples for all new features
• Provided comprehensive API reference for all classes

• Added new class-based API with JsonSon class for more fluent and powerful JSON handling
• Added comprehensive example for the class-based approach
• Maintained full backward compatibility with the functional approach

• Added flexibleMapFromJson and flexibleMapNotNullFromJson functions for flexible map transformations

• Added comprehensive tests for flexibleListFromJson and flexibleListNotNullFromJson

• Added comprehensive tests for flexibleLowerStringFromJson and flexibleUpperStringFromJson

• Added comprehensive tests for flexibleTrimmedStringFromJson

• Added comprehensive tests for flexibleUriFromJson
• Fixed test expectations for flexibleUriFromJson to match actual behavior

• Added comprehensive tests for flexibleDateTimeFromJson

• Added comprehensive tests for flexibleNumFromJson

• Added comprehensive tests for flexibleStringFromJson

• Added comprehensive tests for flexibleBoolFromJson

• Added comprehensive tests for flexibleDoubleFromJson

• Added comprehensive tests for flexibleIntFromJson

• Ran dart format on the codebase
• Code formatting and documentation improvements across the codebase
• Removed unnecessary TODOs and improved code comments
• Enhanced code style consistency in method parameters and documentation

• Removed unused import.

• Renamed package to Just Straightens Out Nonsense (JSON) and to keep it short, made it json_son.

• Added flexibleUpperStringFromJson for converting strings to uppercase after trimming.

• Added flexibleLowerStringFromJson for converting strings to lowercase after trimming.

• Added flexibleTrimmedStringFromJson for trimming whitespace and converting empty strings to null.

• Added flexibleCommaSeparatedListFromJson for parsing comma-separated strings into List<String>?.

• Added flexibleListNotNullFromJson for guaranteeing a non-null list, even if the API returns null or a single item. Returns an empty list for null inputs.

• Added flexibleListFromJson for handling APIs that may return a single item instead of a list, or for parsing list items with a flexible item parser.

• Updated flexible JSON decoder functions:
  • flexibleNumFromJson
  • flexibleDateTimeFromJson
  • flexibleUriFromJson

• Initial release.
• Added flexible JSON decoder functions:
  • flexibleIntFromJson
  • flexibleDoubleFromJson
  • flexibleBoolFromJson
  • flexibleStringFromJson
  • Basic package setup including pubspec.yaml, README.md, and LICENSE.

• Initial version.

MV❤️