From cac899ee401af539d09323c299d99e5027278d00 Mon Sep 17 00:00:00 2001
From: Stuart Turner <stuart@turner-isageek.com>
Date: Tue, 3 Dec 2024 10:16:11 -0600
Subject: [PATCH] Add support for `/cra/check_report/pdf/get` endpoint

---
 src/Plaid/Credit/CheckReportPdfGetRequest.cs  | 14 ++++++++++++
 src/Plaid/Credit/PlaidClient.Manual.cs        | 14 ++++++++++++
 .../CheckReportPdfGetRequestAddOnsEnum.cs     | 22 +++++++++++++++++++
 3 files changed, 50 insertions(+)
 create mode 100644 src/Plaid/Credit/CheckReportPdfGetRequest.cs
 create mode 100644 src/Plaid/Credit/PlaidClient.Manual.cs
 create mode 100644 src/Plaid/Entity/CheckReportPdfGetRequestAddOnsEnum.cs

diff --git a/src/Plaid/Credit/CheckReportPdfGetRequest.cs b/src/Plaid/Credit/CheckReportPdfGetRequest.cs
new file mode 100644
index 0000000..b2c6948
--- /dev/null
+++ b/src/Plaid/Credit/CheckReportPdfGetRequest.cs
@@ -0,0 +1,14 @@
+namespace Going.Plaid.Credit;
+
+/// <summary>
+/// <para>CheckReportPdfGetRequest defines the request schema for <c>/cra/check_report/pdf/get</c></para>
+/// </summary>
+public partial class CheckReportPdfGetRequest : RequestBase
+{
+	/// <summary>
+	/// <para>Use this field to include other reports in the PDF.</para>
+	/// <para>Possible values: <c>cra_income_insights</c></para>
+	/// </summary>
+	[JsonPropertyName("add_ons")]
+	public IReadOnlyList<Entity.CheckReportPdfGetRequestAddOnsEnum> AddOns { get; set; } = default!;
+}
diff --git a/src/Plaid/Credit/PlaidClient.Manual.cs b/src/Plaid/Credit/PlaidClient.Manual.cs
new file mode 100644
index 0000000..cbde16e
--- /dev/null
+++ b/src/Plaid/Credit/PlaidClient.Manual.cs
@@ -0,0 +1,14 @@
+namespace Going.Plaid;
+
+public sealed partial class PlaidClient
+{
+	/// <summary>
+	/// <para>The <c>/cra/check_report/pdf/get</c> retrieves the most recent Consumer Report in PDF format. By default, the most recent Base Report (if it exists) for the user will be returned. To request that the most recent Income Insights report be included in the PDF as well, use the <c>add-ons</c> field.</para>
+	/// <para>The response to <c>/asset_report/pdf/get</c> is the PDF binary data. The <c>request_id</c>  is returned in the <c>Plaid-Request-ID</c> header.</para>
+	/// <para><a href="https://plaid.com/documents/sample-asset-report.pdf">View a sample PDF Asset Report</a></para>
+	/// </summary>
+	/// <remarks><see href="https://plaid.com/docs/api/products/assets/#asset_reportpdfget" /></remarks>
+	public Task<FileResponse> CreditCheckReportPdfGetAsync(Credit.CheckReportPdfGetRequest request) =>
+		PostAsync("/cra/check_report/pdf/get", request)
+			.ParseFileResponseAsync();
+}
diff --git a/src/Plaid/Entity/CheckReportPdfGetRequestAddOnsEnum.cs b/src/Plaid/Entity/CheckReportPdfGetRequestAddOnsEnum.cs
new file mode 100644
index 0000000..950c1b3
--- /dev/null
+++ b/src/Plaid/Entity/CheckReportPdfGetRequestAddOnsEnum.cs
@@ -0,0 +1,22 @@
+namespace Going.Plaid.Entity;
+
+/// <summary>
+/// <para>Use this enum to specify other reports to include in the PDF.</para>
+/// <para>Possible values: <c>cra_income_insights</c></para>
+/// </summary>
+public enum CheckReportPdfGetRequestAddOnsEnum
+{
+
+	/// <summary>
+	/// <para>Include Check Report Income Insights</para>
+	/// </summary>
+	[EnumMember(Value = "cra_income_insights")]
+	CraIncomeInsights,
+
+	/// <summary>
+	/// <para>Catch-all for unknown values returned by Plaid. If you encounter this, please check if there is a later version of the Going.Plaid library.</para>
+	/// </summary>
+	[EnumMember(Value = "undefined")]
+	Undefined,
+
+}