v1.7.5

CHANGELOG.md

@@ -1,3 +1,10 @@
+## 1.7.5
+
+- New `IterableEntityReferenceExtension` and `IterableEntityReferenceListExtension`.
+
+- `EntityReference`: added `idAsInt` and `idNotNullAsInt`.
+- `EntityReferenceList`: added `idsAsInt` and `idsNotNullAsInt`.
+
 ## 1.7.4
 
 - `TimedMap`:

lib/src/bones_api_base.dart

@@ -42,7 +42,7 @@ typedef APILogger = void Function(APIRoot apiRoot, String type, String? message,
 /// Bones API Library class.
 class BonesAPI {
   // ignore: constant_identifier_names
-  static const String VERSION = '1.7.4';
+  static const String VERSION = '1.7.5';
 
   static bool _boot = false;
 

lib/src/bones_api_entity_reference.dart

@@ -704,6 +704,17 @@
   /// See [idAs].
   I idNotNullAs<I>() => id as I;
 
+  /// Returns [id] as [int] or null.
+  /// See [idNotNullAs].
+  int? get idAsInt {
+    var id = this.id;
+    return id is int ? id : null;
+  }
+
+  /// Returns [id] as [int].
+  /// See [idAsInt].
+  int get idNotNullAsInt => id as int;
+
   Object? _resolveID() {
     var id = _id;
     if (id != null) return id;
@@ -1649,6 +1660,15 @@
   /// See [idsAs].
   List<I> idsNotNullAs<I>() => ids?.whereType<I>().toList() ?? [];
 
+  /// Returns the [ids] with type [int] or null.
+  /// See [idsNotNullAs].
+  List<int?> get idsAsInt =>
+      ids?.map((e) => e is int ? e : null).toList() ?? [];
+
+  /// Returns the [ids] with type [int].
+  /// See [idsAsInt].
+  List<int> get idsNotNullAsInt => ids?.whereType<int>().toList() ?? [];
+
   List<Object?>? _resolveIDs() {
     var ids = _ids;
     if (ids != null) return ids;
@@ -2356,6 +2376,38 @@
   FutureOr<List<T?>?> getNotNull() => this?.getNotNull();
 }
 
+extension IterableEntityReferenceExtension<T> on Iterable<EntityReference<T>> {
+  List<Object> get allIDs => map((e) => e.id).whereNotNull().toList();
+
+  List<I> allIDsAs<I>() => map((e) => e.idAs<I>()).whereType<I>().toList();
+
+  List<int> get allIDsAsInt => map((e) => e.idNotNullAsInt).toList();
+
+  List<T> get allEntities => map((e) => e.entity).whereType<T>().toList();
+}
+
+extension IterableEntityReferenceListExtension<T>
+    on Iterable<EntityReferenceList<T>> {
+  List<Object> get allIDs => expand((e) => e.ids ?? []).whereNotNull().toList();
+
+  List<I> allIDsAs<I>() => expand((e) => e.idsAs<I>()).whereType<I>().toList();
+
+  List<int> get allIDsAsInt => expand((e) => e.idsNotNullAsInt).toList();
+
+  List<T> get allEntities => expand((e) => e.entitiesNotNull).toList();
+}
+
+extension IterableOfIterableEntityReferenceListExtension<T>
+    on Iterable<Iterable<EntityReferenceList<T>>> {
+  List<Object> get allIDs => expand((e) => e.allIDs).toList();
+
+  List<I> allIDsAs<I>() => expand((e) => e.allIDsAs<I>()).toList();
+
+  List<int> get allIDsAsInt => expand((e) => e.allIDsAsInt).toList();
+
+  List<T> get allEntities => expand((e) => e.allEntities).toList();
+}
+
 extension _ListExtension<T> on List<T> {
   List<T> mergeWith(List<T> other) => List<T>.generate(length, (i) {
         T a = this[i];

pubspec.yaml

@@ -1,6 +1,6 @@
 name: bones_api
 description: Bones_API - A powerful API backend framework for Dart. It comes with a built-in HTTP Server, route handler, entity handler, SQL translator, and DB adapters.
-version: 1.7.4
+version: 1.7.5
 homepage: https://github.com/Colossus-Services/bones_api
 
 environment: