From f2529df8581e5a2ba71a7b5cb8a828b841702664 Mon Sep 17 00:00:00 2001
From: Taslan Graham <gtaslan1@gmail.com>
Date: Wed, 18 Sep 2024 18:29:25 -0500
Subject: [PATCH] pkp/pkp-lib#10412 Add API endpoints for emailLogEntry

---
 api/v1/emails/index.php      |  19 +++++++
 docs/dev/swagger-source.json | 105 ++++++++++++++++++++++++++++++++++-
 2 files changed, 123 insertions(+), 1 deletion(-)
 create mode 100644 api/v1/emails/index.php

diff --git a/api/v1/emails/index.php b/api/v1/emails/index.php
new file mode 100644
index 00000000000..885bea87724
--- /dev/null
+++ b/api/v1/emails/index.php
@@ -0,0 +1,19 @@
+<?php
+
+/**
+ * @defgroup api_v1_emails Email API requests
+ */
+
+/**
+ * @file api/v1/emails/index.php
+ *
+ * Copyright (c) 2023 Simon Fraser University
+ * Copyright (c) 2023 John Willinsky
+ * Distributed under the GNU GPL v3. For full terms see the file docs/COPYING.
+ *
+ * @ingroup api_v1_submissions
+ *
+ * @brief Handle requests for emails API functions.
+ *
+ */
+return new \PKP\handler\APIHandler(new \PKP\API\v1\emails\PKPEmailController());
diff --git a/docs/dev/swagger-source.json b/docs/dev/swagger-source.json
index bc9c7b6a31c..7a7cf2fdcc0 100644
--- a/docs/dev/swagger-source.json
+++ b/docs/dev/swagger-source.json
@@ -58,7 +58,8 @@
 				"Stats / Sushi",
 				"Vocabs",
 				"Temporary Files",
-				"Backend"
+				"Backend",
+				"Emails"
 			]
 		}
 	],
@@ -202,6 +203,10 @@
 		{
 			"name": "Backend",
 			"description": "Private endpoints for OJS's UI. These endpoints will be less stable between versions. We discourage their use in third-party plugins or applications."
+		},
+		{
+			"name": "Emails",
+			"description": "Endpoints used to retrieve user emails."
 		}
 	],
 	"definitions": {
@@ -283,6 +288,7 @@
 			}
 		},
 		"EmailTemplate": "emailTemplate",
+		"Email": "emailLog",
 		"Galley": "galley",
 		"Institution": "institution",
 		"InvalidParametersResponse": {
@@ -4866,6 +4872,103 @@
 				}
 			}
 		},
+		"/emails/authorEmails": {
+			"get": {
+				"tags": [
+					"Emails"
+				],
+				"summary": "Gets an Author's email entry logs.",
+				"parameters": [
+					{
+						"name": "submissionId",
+						"description": "Filter results to emails associated with a specific submissionId.",
+						"in": "query",
+						"required": false,
+						"type": "integer"
+					},
+					{
+						"name": "eventType",
+						"description": "Filter results by an event type",
+						"in": "query",
+						"required": false,
+						"type": "integer"
+					}
+				],
+				"responses":  {
+					"200": {
+						"x-summary": "Success",
+						"description": "List of email.",
+						"schema": {
+							"type": "array",
+							"items": {
+								"$ref": "#/definitions/EmailSummary"
+							}
+						}
+					},
+					"403": {
+						"x-summary": "Request Unauthorized",
+						"description": "You do not have permission to view emails.",
+						"schema": {
+							"$ref": "#/definitions/ErrorResponse"
+						}
+					},
+					"404": {
+						"x-summary": "Request Not Found",
+						"description": "No matching resource for a provided query param. Example: no submission found matching the provided `submissionId` query param.",
+						"schema": {
+							"$ref": "#/definitions/ErrorResponse"
+						}
+					},
+					"400": {
+						"x-summary": "Request Invalid",
+						"description": "Your request was not valid. One or more of the request query params are invalid. The error message will contain details about the invalid query param.",
+						"schema": {
+							"$ref": "#/definitions/ErrorResponse"
+						}
+					}
+				}
+			}
+		},
+		"/emails/{emailId}": {
+			"get": {
+				"tags": [
+					"Emails"
+				],
+				"summary": "Get an email entry log by ID",
+				"parameters": [
+					{
+						"name": "emailId",
+						"description": "Email ID",
+						"in": "path",
+						"required": true,
+						"type": "integer"
+					}
+				],
+				"responses": {
+					"200": {
+						"x-summary": "Success",
+						"description": "The email entry log details.",
+						"schema": {
+							"$ref": "#/definitions/EmailSummary"
+						}
+					},
+					"403": {
+						"x-summary": "Request Unauthorized",
+						"description": "You do not have permission to access this email.",
+						"schema": {
+							"$ref": "#/definitions/ErrorResponse"
+						}
+					},
+					"404": {
+						"x-summary": "Request Not Found",
+						"description": "The email could not be found.",
+						"schema": {
+							"$ref": "#/definitions/ErrorResponse"
+						}
+					}
+				}
+			}
+		},
 		"/institutions": {
 			"get": {
 				"tags": [