From 97fbd375ee1d3f5c4d94865e127a28883bfd4960 Mon Sep 17 00:00:00 2001
From: gmpassos <gracilianomp@gmail.com>
Date: Tue, 21 May 2024 01:59:47 -0300
Subject: [PATCH] v1.7.5

- New `IterableEntityReferenceExtension` and `IterableEntityReferenceListExtension`.

- `EntityReference`: added `idAsInt` and `idNotNullAsInt`.
- `EntityReferenceList`: added `idsAsInt` and `idsNotNullAsInt`.
---
 CHANGELOG.md                            |  7 ++++
 lib/src/bones_api_base.dart             |  2 +-
 lib/src/bones_api_entity_reference.dart | 52 +++++++++++++++++++++++++
 pubspec.yaml                            |  2 +-
 4 files changed, 61 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3fa9dcd..1824071 100644
--- a/CHANGELOG.md
+++ b/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`:
diff --git a/lib/src/bones_api_base.dart b/lib/src/bones_api_base.dart
index e066d1c..c1aec31 100644
--- a/lib/src/bones_api_base.dart
+++ b/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;
 
diff --git a/lib/src/bones_api_entity_reference.dart b/lib/src/bones_api_entity_reference.dart
index 6d4954c..70bd66e 100644
--- a/lib/src/bones_api_entity_reference.dart
+++ b/lib/src/bones_api_entity_reference.dart
@@ -704,6 +704,17 @@ class EntityReference<T> extends EntityReferenceBase<T> {
   /// 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 @@ class EntityReferenceList<T> extends EntityReferenceBase<T> {
   /// 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 @@ extension NullEntityReferenceListExtension<T> on EntityReferenceList<T>? {
   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];
diff --git a/pubspec.yaml b/pubspec.yaml
index f77b6c6..afff727 100644
--- a/pubspec.yaml
+++ b/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: