chore: package rename

Author: fulleni

.github/dependabot.yaml

@@ -10,4 +10,5 @@ updates:
     schedule:
       interval: "weekly"
     ignore:
-      - dependency-name: "ht_*"
+      - dependency-name: "data_client"
+      - dependency-name: "core"

.github/workflows/main.yaml

@@ -1,4 +1,4 @@
-name: ci
+name: main
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}

README.md

@@ -1,65 +1,65 @@
-# ht_data_mongodb
+# data_mongodb
 
 ![coverage: 95%](https://img.shields.io/badge/coverage-95-green)
 [![style: very good analysis](https://img.shields.io/badge/style-very_good_analysis-B22C89.svg)](https://pub.dev/packages/very_good_analysis)
 [![License: PolyForm Free Trial](https://img.shields.io/badge/License-PolyForm%20Free%20Trial-blue)](https://polyformproject.org/licenses/free-trial/1.0.0)
 
-A production-ready MongoDB implementation of the `HtDataClient` interface, designed to connect Dart and Flutter applications to a MongoDB backend. This package is part of the Headlines Toolkit (HT) ecosystem.
+A production-ready MongoDB implementation of the `DataClient` interface, designed to connect Dart and Flutter applications to a MongoDB backend. This package is part of the [**Flutter News App - Full Source Code Toolkit**](https://github.com/flutter-news-app-full-source-code).
 
 ## Description
 
-`HtDataMongodb` provides a robust, concrete implementation of the `HtDataClient` interface using the `mongo_dart` package. It acts as the bridge between your application's repositories and a MongoDB database.
+`DataMongodb` provides a robust, concrete implementation of the `DataClient` interface using the `mongo_dart` package. It acts as the bridge between your application's repositories and a MongoDB database.
 
-It translates the abstract, high-level data requests from the `HtDataClient` interface—including rich filters, multi-field sorting, and cursor-based pagination—into native, efficient MongoDB queries.
+It translates the abstract, high-level data requests from the `DataClient` interface—including rich filters, multi-field sorting, and cursor-based pagination—into native, efficient MongoDB queries.
 
-A key feature of this implementation is its **ID management strategy**. It ensures that the application layer remains the source of truth for a document's ID by mapping the model's `id` string to the database's `_id` field. This is crucial for correctly handling both global documents (like headlines) and user-owned documents (like settings), where the document's `_id` must match the user's ID. For a deeper explanation, see the documentation within the `HtDataMongodb` class.
+A key feature of this implementation is its **ID management strategy**. It ensures that the application layer remains the source of truth for a document's ID by mapping the model's `id` string to the database's `_id` field. This is crucial for correctly handling both global documents (like headlines) and user-owned documents (like settings), where the document's `_id` must match the user's ID. For a deeper explanation, see the documentation within the `DataMongodb` class.
 
 ## Getting Started
 
 This package is intended to be used as a dependency in backend services (like a Dart Frog API) or applications that connect directly to MongoDB.
 
-To use this package, add `ht_data_mongodb` and its peer dependencies to your `pubspec.yaml`.
+To use this package, add `data_mongodb` and its peer dependencies to your `pubspec.yaml`.
 
 ```yaml
 dependencies:
-  # ht_data_client defines the interface this package implements.
-  ht_data_client:
+  # data_client defines the interface this package implements.
+  data_client:
     git:
-      url: https://github.com/headlines-toolkit/ht-data-client.git
+      url: https://github.com/flutter-news-app-full-source-code/data-client.git
       # ref: <specific_commit_or_tag>
-  # ht_shared is needed for models and exceptions.
-  ht_shared:
+  # core is needed for models and exceptions.
+  core:
     git:
-      url: https://github.com/headlines-toolkit/ht-shared.git
+      url: https://github.com/flutter-news-app-full-source-code/core.git
       # ref: <specific_commit_or_tag>
-  ht_data_mongodb:
+  data_mongodb:
     git:
-      url: https://github.com/headlines-toolkit/ht-data-mongodb.git
+      url: https://github.com/flutter-news-app-full-source-code/data-mongodb.git
       # ref: <specific_commit_or_tag>
 ```
 
 Then run `dart pub get` or `flutter pub get`.
 
 ## Features
 
-- Implements the `HtDataClient<T>` interface from `package:ht_data_client`.
+- Implements the `DataClient<T>` interface from `package:data_client`.
 - Includes `MongoDbConnectionManager` for robust connection lifecycle management.
 - Translates `readAll` parameters (`filter`, `sort`, `pagination`) into native MongoDB queries.
 - **Handles ID Management**: Faithfully maps the application-level `id` string to the database `_id`, preserving data integrity for all document types.
 - **Supports Multiple Data Models**: Correctly handles both global documents (e.g., `Headline`) and user-owned documents (e.g., `UserAppSettings`) where the document `_id` serves as the foreign key to the user.
-- Throws standard exceptions from `package:ht_shared` for consistent error handling.
+- Throws standard exceptions from `package:core` for consistent error handling.
 - Implements `count` for efficient document counting.
 - Implements `aggregate` to execute powerful, server-side aggregation pipelines.
 - **Partial Text Search**: Translates a `q` filter parameter into a case-insensitive (`$regex`) across designated searchable fields.
 
 ## Usage
 
-Here's a basic example of how to use `HtDataMongodb` with a simple `Product` model.
+Here's a basic example of how to use `DataMongodb` with a simple `Product` model.
 
 ```dart
-import 'package:ht_data_client/ht_data_client.dart';
-import 'package:ht_data_mongodb/ht_data_mongodb.dart';
-import 'package:ht_shared/ht_shared.dart';
+import 'package:data_client/data_client.dart';
+import 'package:data_mongodb/data_mongodb.dart';
+import 'package:core/core.dart';
 
 // 1. Define your model.
 class Product {
@@ -89,7 +89,7 @@ void main() async {
     await connectionManager.init(connectionString);
 
     // 4. Instantiate the client for your model.
-    final client = HtDataMongodb<Product>(
+    final client = DataMongodb<Product>(
       connectionManager: connectionManager,
       modelName: 'products', // The name of the MongoDB collection.
       fromJson: Product.fromJson,
@@ -143,7 +143,7 @@ void main() async {
         'Average product price: \$${aggregateResponse.data.first['averagePrice']}',
       );
     }
-  } on HtHttpException catch (e) {
+  } on HttpException catch (e) {
     print('An error occurred: ${e.message}');
   } finally {
     // 6. Always close the connection.
@@ -152,6 +152,9 @@ void main() async {
 }
 ```
 
-## License
 
-This package is licensed under the [PolyForm Free Trial 1.0.0](/LICENSE). Please review the terms before use.
+## 🔑 Licensing
+
+This package is source-available and licensed under the [PolyForm Free Trial 1.0.0](LICENSE). Please review the terms before use.
+
+For commercial licensing options that grant the right to build and distribute unlimited applications, please visit the main [**Flutter News App - Full Source Code Toolkit**](https://github.com/flutter-news-app-full-source-code) organization.

coverage/lcov.info

@@ -11,7 +11,7 @@ DA:37,0
 LF:9
 LH:0
 end_of_record
-SF:lib/src/ht_data_mongodb.dart
+SF:lib/src/data_mongodb.dart
 DA:16,1
 DA:26,2
 DA:36,5

coverage_badge.svg

@@ -0,0 +1,5 @@
+/// A production-ready MongoDB implementation of the `DataClient` interface.
+library;
+
+export 'src/data_mongodb.dart';
+export 'src/mongo_db_connection_manager.dart';

lib/data_mongodb.dart

@@ -1,14 +1,14 @@
-// ignore_for_file: cascade_invocations
+// ignore_for_file: cascade_invocations, public_member_api_docs
 
-import 'package:ht_data_client/ht_data_client.dart';
-import 'package:ht_data_mongodb/src/mongo_db_connection_manager.dart';
-import 'package:ht_shared/ht_shared.dart';
+import 'package:core/core.dart';
+import 'package:data_client/data_client.dart';
+import 'package:data_mongodb/src/mongo_db_connection_manager.dart';
 import 'package:logging/logging.dart';
 import 'package:mongo_dart/mongo_dart.dart';
 import 'package:uuid/uuid.dart';
 
-/// {@template ht_data_mongodb}
-/// A MongoDB implementation of the [HtDataClient] interface.
+/// {@template data_mongodb}
+/// A MongoDB implementation of the [DataClient] interface.
 ///
 /// This client interacts with a MongoDB database to perform CRUD operations,
 /// translating the generic data client requests into native MongoDB queries.
@@ -43,7 +43,7 @@ import 'package:uuid/uuid.dart';
 ///
 /// ### The `userId` Parameter: A Critical Clarification
 ///
-/// The [HtDataClient] interface, being generic, includes an optional `userId`
+/// The [DataClient] interface, being generic, includes an optional `userId`
 /// parameter on its methods (e.g., `create({required T item, String? userId})`).
 /// This is to support data schemas where documents might have a `userId` field.
 ///
@@ -61,20 +61,20 @@ import 'package:uuid/uuid.dart';
 /// is to faithfully execute the resulting database operation (e.g., "fetch the
 /// document with this `_id`").
 /// {@endtemplate}
-class HtDataMongodb<T> implements HtDataClient<T> {
-  /// {@macro ht_data_mongodb}
-  HtDataMongodb({
+class DataMongodb<T> implements DataClient<T> {
+  /// {@macro data_mongodb}
+  DataMongodb({
     required MongoDbConnectionManager connectionManager,
     required String modelName,
     required FromJson<T> fromJson,
     required ToJson<T> toJson,
     this.searchableFields,
     Logger? logger,
-  })  : _connectionManager = connectionManager,
-        _modelName = modelName,
-        _fromJson = fromJson,
-        _toJson = toJson,
-        _logger = logger ?? Logger('HtDataMongodb<$T>');
+  }) : _connectionManager = connectionManager,
+       _modelName = modelName,
+       _fromJson = fromJson,
+       _toJson = toJson,
+       _logger = logger ?? Logger('DataMongodb<$T>');
 
   final MongoDbConnectionManager _connectionManager;
   final List<String>? searchableFields;
@@ -117,7 +117,9 @@ class HtDataMongodb<T> implements HtDataClient<T> {
 
     if (id == null || id.isEmpty) {
       // This should not happen if models are validated correctly upstream.
-      throw const BadRequestException('Model is missing a required "id" field.');
+      throw const BadRequestException(
+        'Model is missing a required "id" field.',
+      );
     }
 
     // Ensure the ID is a valid hex string for ObjectId conversion.
@@ -174,7 +176,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
         processedFilter.clear();
         processedFilter[r'$and'] = [
           otherFilters,
-          {r'$or': searchConditions}
+          {r'$or': searchConditions},
         ];
       }
     } else if (processedFilter.containsKey('q')) {
@@ -296,11 +298,11 @@ class HtDataMongodb<T> implements HtDataClient<T> {
           'Failed to create item: ${writeResult.writeError?.errmsg}',
         );
       }
-      _logger..finer('insertOne successful for _id: ${doc['_id']}')
-
-      // Best Practice: After insertion, fetch the canonical document from the
-      // database to ensure the returned data is exactly what was stored.
-      ..finer('Fetching newly created document for verification...');
+      _logger
+        ..finer('insertOne successful for _id: ${doc['_id']}')
+        // Best Practice: After insertion, fetch the canonical document from the
+        // database to ensure the returned data is exactly what was stored.
+        ..finer('Fetching newly created document for verification...');
       final createdDoc = await _collection.findOne({'_id': doc['_id']});
       if (createdDoc == null) {
         _logger.severe(
@@ -320,7 +322,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
           timestamp: DateTime.now(),
         ),
       );
-    } on HtHttpException {
+    } on HttpException {
       rethrow;
     } on Exception catch (e, s) {
       _logger.severe('Error during create in $_modelName', e, s);
@@ -338,9 +340,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
         throw BadRequestException('Invalid ID format: "$id"');
       }
 
-      final selector = <String, dynamic>{
-        '_id': ObjectId.fromHexString(id),
-      };
+      final selector = <String, dynamic>{'_id': ObjectId.fromHexString(id)};
       _logger.finer('Using delete selector: $selector');
 
       final writeResult = await _collection.deleteOne(selector);
@@ -355,7 +355,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
       }
       _logger.fine('Successfully deleted document with id: $id');
       // No return value on success
-    } on HtHttpException {
+    } on HttpException {
       rethrow;
     } on Exception catch (e, s) {
       _logger.severe('Error during delete in $_modelName', e, s);
@@ -377,9 +377,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
         throw BadRequestException('Invalid ID format: "$id"');
       }
 
-      final selector = <String, dynamic>{
-        '_id': ObjectId.fromHexString(id),
-      };
+      final selector = <String, dynamic>{'_id': ObjectId.fromHexString(id)};
       _logger.finer('Using read selector: $selector');
 
       final doc = await _collection.findOne(selector);
@@ -388,9 +386,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
         _logger.warning(
           'Read FAILED: Item with id "$id" not found in $_modelName.',
         );
-        throw NotFoundException(
-          'Item with ID "$id" not found in $_modelName.',
-        );
+        throw NotFoundException('Item with ID "$id" not found in $_modelName.');
       }
       _logger.fine('Successfully read document with id: $id');
 
@@ -402,7 +398,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
           timestamp: DateTime.now(),
         ),
       );
-    } on HtHttpException {
+    } on HttpException {
       rethrow;
     } on Exception catch (e, s) {
       _logger.severe('Error during read in $_modelName', e, s);
@@ -432,11 +428,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
 
       // Fetch one extra item to determine if there are more pages.
       final findResult = await _collection
-          .modernFind(
-            filter: selector,
-            sort: sortBuilder,
-            limit: limit + 1,
-          )
+          .modernFind(filter: selector, sort: sortBuilder, limit: limit + 1)
           .toList();
 
       final hasMore = findResult.length > limit;
@@ -466,7 +458,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
           timestamp: DateTime.now(),
         ),
       );
-    } on HtHttpException {
+    } on HttpException {
       rethrow;
     } on Exception catch (e, s) {
       _logger.severe('Error during readAll in $_modelName', e, s);
@@ -488,9 +480,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
         throw BadRequestException('Invalid ID format: "$id"');
       }
 
-      final selector = <String, dynamic>{
-        '_id': ObjectId.fromHexString(id),
-      };
+      final selector = <String, dynamic>{'_id': ObjectId.fromHexString(id)};
       _logger.finer('Using update selector: $selector');
 
       // Prepare the document for update. Note that the `_id` from the item
@@ -523,7 +513,7 @@ class HtDataMongodb<T> implements HtDataClient<T> {
           timestamp: DateTime.now(),
         ),
       );
-    } on HtHttpException {
+    } on HttpException {
       rethrow;
     } on Exception catch (e, s) {
       _logger.severe('Error during update in $_modelName', e, s);
@@ -575,8 +565,9 @@ class HtDataMongodb<T> implements HtDataClient<T> {
       // to a specific user-owned document) or other fields directly in the
       // provided pipeline by the caller.
 
-      final results =
-          await _collection.aggregateToStream(finalPipeline).toList();
+      final results = await _collection
+          .aggregateToStream(finalPipeline)
+          .toList();
 
       return SuccessApiResponse(
         data: results,

lib/ht_data_mongodb.dart

@@ -1,4 +1,4 @@
-import 'package:ht_shared/ht_shared.dart';
+import 'package:core/core.dart';
 import 'package:mongo_dart/mongo_dart.dart';
 
 /// Manages the connection to a MongoDB database.