eng: deprecate FieldSerializable#nullable #520

Author: tshedor

docs/data/fields.md

@@ -15,7 +15,6 @@ As providers are ultimately responsible for converting raw data into model data,
 | `ignore:`       | Do not deserialize (from) or serialize (to) this field to a provider                                                                                                                                                                     | `@Rest(ignore: true)`                                              |
 | `name:`         | Stored key for this field according to the provider. In SQLite, for example, this would be the column name.                                                                                                                              | `@Sqlite(name: "address_2")`                                       |
 | `defaultValue:` | Value to use in absence or `null` of the instance. It does not dictate what the Dart model will hold on empty instantiation. **Recommended to use Dart's default constructor assignment instead**.                                       | `@Rest(defaultValue: '[]')`                                        |
-| `nullable:`     | `null` fields are handled gracefully when serializing and deserializing.                                                                                                                                                                 | `@Rest(nullable: true)`                                            |
 | `fromGenerator` | A stringified function with access to [placeholders](#placeholders); replaces adapter's generated deserialize code for the field. Do not include trailing semicolons or function body wrapping symbols (`{}` or `=>`) in the definition. | `@Rest(fromGenerator: "int.tryParse(%DATA_PROPERTY%.toString())")` |
 | `toGenerator`   | A stringified function with access to [placeholders](#placeholders); replaces adapter's generated serialize code for the field. Do not include trailing semicolons or function body wrapping symbols (`{}` or `=>`) in the definition.   | `@Sqlite(toGenerator: "%INSTANCE_PROPERTY% > 1 ? 1 : 0")`          |
 

packages/brick_build/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## Unreleased
 
+## 3.3.1
+
+- Remove `FieldSerializable#nullable` requirement on `deserializerNullableClause`
+- Update minimum `brick_core` to `1.4.0`
+
 ## 3.3.0
 
 - Add documentation to increase pub.dev score

packages/brick_build/example/file_fields.dart

@@ -1,6 +1,6 @@
 import 'package:analyzer/dart/element/element.dart';
-import 'package:brick_core/field_serializable.dart';
 import 'package:brick_build/generators.dart';
+import 'package:brick_core/field_serializable.dart';
 
 // in a real-world equivalent, this is an annotation
 class File implements FieldSerializable {
@@ -52,7 +52,7 @@ class _FileSerdesFinder extends AnnotationFinder<File> {
   _FileSerdesFinder();
 
   @override
-  File from(element) {
+  File from(FieldElement element) {
     final obj = objectForField(element);
 
     if (obj == null) {

packages/brick_build/lib/src/serdes_generator.dart

@@ -268,7 +268,7 @@ abstract class SerdesGenerator<FieldAnnotation extends FieldSerializable,
     required FieldAnnotation fieldAnnotation,
     required String name,
   }) =>
-      fieldAnnotation.nullable && field.type.nullabilitySuffix != NullabilitySuffix.none
+      field.type.nullabilitySuffix != NullabilitySuffix.none
           ? "data['$name'] == null ? null :"
           : '';
 

packages/brick_build/pubspec.yaml

@@ -4,14 +4,14 @@ homepage: https://github.com/GetDutchie/brick/tree/main/packages/brick_build
 issue_tracker: https://github.com/GetDutchie/brick/issues
 repository: https://github.com/GetDutchie/brick
 
-version: 3.3.0
+version: 3.3.1
 
 environment:
   sdk: ">=2.18.0 <4.0.0"
 
 dependencies:
   analyzer: ">=6.0.0 <7.0.0"
-  brick_core: ^1.3.0
+  brick_core: ">=1.4.0 <2.0.0"
   build: ^2.3.0
   dart_style: ">=2.0.0 <3.0.0"
   glob: ">=2.1.0 <3.0.0"

packages/brick_core/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## Unreleased
 
+## 1.4.0
+
+- **DEPRECATION** remove `FieldSerializable#nullable`. Builders should evaluate the nullable suffix of the field instead
+
 ## 1.3.1
 
 - `const`antize `Where.exactly` and `OrderBy.{desc|asc}`

packages/brick_core/lib/field_serializable.dart

@@ -45,6 +45,7 @@ abstract class FieldSerializable {
 
   /// When `true`, `null` fields are handled gracefully when serializing and deserializing.
   /// For Dart >=2.12, the member type must also be nullable (i.e. `bool?`).
+  @Deprecated('Use a nullable type instead')
   bool get nullable;
 
   /// Manipulates output for the field in the serialize generator.

packages/brick_core/pubspec.yaml

@@ -4,7 +4,7 @@ homepage: https://github.com/GetDutchie/brick/tree/main/packages/brick_core
 issue_tracker: https://github.com/GetDutchie/brick/issues
 repository: https://github.com/GetDutchie/brick
 
-version: 1.3.1
+version: 1.4.0
 
 environment:
   sdk: ">=3.0.0 <4.0.0"

packages/brick_graphql/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## Unreleased
 
+## 3.3.0
+
+- **DEPRECATION** remove `Graphql#nullable`. Builders should evaluate the nullable suffix of the field instead
+
 ## 3.2.0
 
 - **DEPRECATION** `Query(providerArgs: {'context':})` is now `Query(forProviders: [GraphqlProviderQuery(context:)])`

packages/brick_graphql/lib/src/annotations/graphql.dart

@@ -34,6 +34,7 @@ class Graphql implements FieldSerializable {
   /// This indicates that the payload from GraphQL could be `null` and is not related to
   /// Dart nullability. Defaults to `false`.
   @override
+  @Deprecated('Use a nullable type instead')
   final bool nullable;
 
   /// Supply subfields that should be requested from the server.
@@ -58,7 +59,7 @@ class Graphql implements FieldSerializable {
     bool? ignoreFrom,
     bool? ignoreTo,
     this.name,
-    bool? nullable,
+    @Deprecated('Use a nullable type instead') bool? nullable,
     this.subfields,
     this.toGenerator,
   })  : enumAsString = enumAsString ?? false,