chore: renamed the package

Author: fulleni

.github/dependabot.yaml

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

README.md

@@ -1,20 +1,20 @@
-# ht_email_client
+# email_client
 
 ![coverage: percentage](https://img.shields.io/badge/coverage-XX-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)
 
-Defines the abstract interface for email clients used within the Headlines Toolkit backend system. This package provides the contract (`HtEmailClient`) that concrete implementations (e.g., SMTP, AWS SES, SendGrid clients) should adhere to.
+This package provides the contract (`EmailClient`) that concrete implementations (e.g., SMTP, AWS SES, SendGrid clients) should adhere to.
 
 ## Getting Started
 
 To use this package in your Dart backend project (like Dart Frog), add it to your `pubspec.yaml` file:
 
 ```yaml
 dependencies:
-  ht_email_client:
+  email_client:
     git:
-      url: https://github.com/headlines-toolkit/ht-email-client.git
+      url: https://github.com/flutter-news-app-full-source-code/email-client.git
       # Use a specific ref/tag for stability in production
       # ref: main 
 ```
@@ -23,29 +23,29 @@ Then run `dart pub get`.
 
 ## Features
 
-*   **`HtEmailClient` Abstract Class:** Defines a generic, provider-agnostic interface for sending transactional emails. This approach decouples application logic from email content and styling, which can be managed directly within your email service provider (e.g., SendGrid, AWS SES).
-    *   `Future<void> sendTransactionalEmail({required String senderEmail, required String recipientEmail, required String templateId, required Map<String, dynamic> templateData})`: Sends an email using a pre-defined template. Implementations must handle underlying service errors and map them to standard `ht_shared` exceptions.
+*   **`EmailClient` Abstract Class:** Defines a generic, provider-agnostic interface for sending transactional emails. This approach decouples application logic from email content and styling, which can be managed directly within your email service provider (e.g., SendGrid, AWS SES).
+    *   `Future<void> sendTransactionalEmail({required String senderEmail, required String recipientEmail, required String templateId, required Map<String, dynamic> templateData})`: Sends an email using a pre-defined template. Implementations must handle underlying service errors and map them to standard `core` exceptions.
 
 ## Usage
 
-This package only provides the abstract interface. You need a concrete implementation package (e.g., `ht_email_sendgrid`) that implements `HtEmailClient`.
+This package only provides the abstract interface. You need a concrete implementation package (e.g., `ht_email_sendgrid`) that implements `EmailClient`.
 
 In your backend application (e.g., Dart Frog), you would typically:
 
 1.  Depend on a concrete implementation package.
 2.  Configure and provide an instance of the concrete client using dependency injection.
-3.  Inject `HtEmailClient` into your services where email sending is required.
+3.  Inject `EmailClient` into your services where email sending is required.
 
 ```dart
 // Example (Conceptual - in a service or route handler)
-import 'package:ht_email_client/ht_email_client.dart';
-import 'package:ht_shared/ht_shared.dart';
+import 'package:email_client/email_client.dart';
+import 'package:core/core.dart';
 
 class AuthService {
-  const AuthService({required HtEmailClient emailClient}) 
+  const AuthService({required EmailClient emailClient}) 
     : _emailClient = emailClient;
 
-  final HtEmailClient _emailClient;
+  final EmailClient _emailClient;
 
   Future<void> sendVerificationEmail(String email, String otp) async {
     try {
@@ -61,14 +61,17 @@ class AuthService {
         },
       );
       // Handle success
-    } on HtHttpException {
+    } on HttpException {
       // Handle specific email sending errors (e.g., log, return error response)
       rethrow; 
     }
   }
 }
 ```
 
-## License
 
-This package is licensed under the [PolyForm Free Trial](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.

lib/email_client.dart

@@ -0,0 +1,6 @@
+/// This package provides the contract (EmailClient) that concrete 
+/// implementations (e.g., SMTP, AWS SES, SendGrid clients) should 
+/// adhere to.
+library;
+
+export 'src/email_client.dart';

lib/ht_email_client.dart

@@ -1,15 +1,15 @@
-import 'package:ht_shared/ht_shared.dart';
+import 'package:core/core.dart';
 
-/// {@template ht_email_client}
+/// {@template email_client}
 /// Defines the interface for sending emails within the backend system.
 ///
 /// Concrete implementations (e.g., using specific email providers like
 /// SendGrid, AWS SES, or a local SMTP server for testing) will handle the
 /// actual email dispatch.
 /// {@endtemplate}
-abstract class HtEmailClient {
-  /// {@macro ht_email_client}
-  const HtEmailClient();
+abstract class EmailClient {
+  /// {@macro email_client}
+  const EmailClient();
 
   /// Sends a transactional email using a pre-defined template.
   ///
@@ -25,7 +25,7 @@ abstract class HtEmailClient {
   /// - [templateData]: A map of dynamic data to be merged into the template.
   ///   For example: `{'otpCode': '123456', 'username': 'Alex'}`.
   ///
-  /// Throws [HtHttpException] or its subtypes on failure:
+  /// Throws [HttpException] or its subtypes on failure:
   /// - [InvalidInputException] if input parameters are invalid.
   /// - [NetworkException] for connectivity issues with the email service.
   /// - [ServerException] if the email service reports a server-side error.

lib/src/ht_email_client.dart renamed to lib/src/email_client.dart

@@ -1,17 +1,17 @@
-name: ht_email_client
-description: Defines the abstract interface for email clients used within the Headlines Toolkit backend systems.
-repository: https://github.com/headlines-toolkit/ht-email-client
+name: email_client
+description: This package provides the contract (EmailClient) that concrete implementations (e.g., SMTP, AWS SES, SendGrid clients) should adhere to.
+repository: https://github.com/flutter-news-app-full-source-code/email-client
 publish_to: none
 
 environment:
   sdk: ^3.8.0
 
 dependencies: 
-  ht_shared:
+  core:
     git:
-      url: https://github.com/headlines-toolkit/ht-shared.git
+      url: https://github.com/flutter-news-app-full-source-code/core.git
 
 dev_dependencies:
   mocktail: ^1.0.4
   test: ^1.25.8
-  very_good_analysis: ^7.0.0
+  very_good_analysis: ^9.0.0

pubspec.yaml

@@ -0,0 +1,19 @@
+import 'package:email_client/email_client.dart';
+import 'package:mocktail/mocktail.dart';
+import 'package:test/test.dart';
+
+// A mock implementation of the EmailClient for testing purposes.
+class MockEmailClient extends Mock implements EmailClient {}
+
+void main() {
+  group('EmailClient', () {
+    late EmailClient emailClient;
+    setUp(() {
+      emailClient = MockEmailClient();
+    });
+
+    test('can be implemented', () {
+      expect(emailClient, isA<EmailClient>());
+    });
+  });
+}