implement IFacturapiClient interface for improved testing support

javorosas · javorosas · commit a604308c74d3 · 2025-12-10T15:12:42.000-07:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [5.0.0] - Unreleased
+## [5.0.0] - 2025-12-10
 
 ### Breaking
 
@@ -14,10 +14,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - `FacturapiException.Status` now surfaces the HTTP status code when available.
+- Introduced `IFacturapiClient` so consumers can mock the client surface in tests.
 
 ### Changed
 
-- `FacturapiClient` now implements `IDisposable`; dispose it when finished to release HTTP resources. If not disposed, garbage collection will eventually clean up, but explicit disposal avoids lingering HTTP connections.
+- `FacturapiClient` now implements `IDisposable`; call `Dispose()` when finished (or wrap in `using`) to release HTTP resources. If not disposed, garbage collection will eventually clean up, but explicit disposal avoids lingering HTTP connections.
 
 ## [4.11.0] - 2025-12-10
 
diff --git a/FacturapiClient.cs b/FacturapiClient.cs
@@ -5,7 +5,7 @@
 
 namespace Facturapi
 {
-    public class FacturapiClient : IDisposable
+    public class FacturapiClient : IFacturapiClient
     {
         public Wrappers.CustomerWrapper Customer { get; private set; }
         public Wrappers.ProductWrapper Product { get; private set; }
diff --git a/IFacturapiClient.cs b/IFacturapiClient.cs
@@ -0,0 +1,18 @@
+﻿using Facturapi.Wrappers;
+using System;
+
+namespace Facturapi
+{
+    public interface IFacturapiClient : IDisposable
+    {
+        CustomerWrapper Customer { get; }
+        ProductWrapper Product { get; }
+        InvoiceWrapper Invoice { get; }
+        OrganizationWrapper Organization { get; }
+        ReceiptWrapper Receipt { get; }
+        RetentionWrapper Retention { get; }
+        CatalogWrapper Catalog { get; }
+        CatalogWrapper CartaporteCatalog { get; }
+        ToolWrapper Tool { get; }
+    }
+}

Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@`
`5`	`5`
`6`	`6`	`namespace Facturapi`
`7`	`7`	`{`
`8`		`- public class FacturapiClient : IDisposable`
	`8`	`+ public class FacturapiClient : IFacturapiClient`
`9`	`9`	`{`
`10`	`10`	`public Wrappers.CustomerWrapper Customer { get; private set; }`
`11`	`11`	`public Wrappers.ProductWrapper Product { get; private set; }`