Full set of Gemini status codes

2 files changed, 106 insertions, 2 deletions

diff --git a/src/gemini.h b/src/gemini.h
index 3c00d425..ffe269df 100644
--- a/src/gemini.h
+++ b/src/gemini.h
@@ -1,9 +1,12 @@
 #pragma once
 
+#include <the_Foundation/string.h>
+
 /* Response status codes. */
 enum iGmStatusCode {
-    failedToOpenFile_GmStatusCode          = -2,
-    invalidHeader_GmStatusCode             = -1,
+    invalidRedirect_GmStatusCode           = -3,
+    invalidHeader_GmStatusCode             = -2,
+    failedToOpenFile_GmStatusCode          = -1,
     none_GmStatusCode                      = 0,
     input_GmStatusCode                     = 10,
     sensitiveInput_GmStatusCode            = 11,
@@ -24,3 +27,13 @@ enum iGmStatusCode {
     certificateNotAuthorized_GmStatusCode  = 61,
     certificateNotValid_GmStatusCode       = 62,
 };
+
+iDeclareType(GmError)
+
+struct Impl_GmError {
+    iChar icon;
+    const char *title;
+    const char *info;
+};
+
+const iGmError *    get_GmError (enum iGmStatusCode code);
diff --git a/src/gmutil.c b/src/gmutil.c
index ce50f015..0270c2a7 100644
--- a/src/gmutil.c
+++ b/src/gmutil.c
@@ -1,4 +1,5 @@
 #include "gmutil.h"
+#include "gemini.h"
 
 #include <the_Foundation/regexp.h>
 #include <the_Foundation/object.h>
@@ -32,3 +33,93 @@ void urlEncodeSpaces_String(iString *d) {
         insertData_Block(&d->chars, pos, "%20", 3);
     }
 }
+
+const iGmError *get_GmError(enum iGmStatusCode code) {
+    static const iGmError none = { 0, "", "" };
+    static const struct {
+        enum iGmStatusCode code;
+        iGmError           err;
+    } errors[] = {
+        { failedToOpenFile_GmStatusCode,
+          { 0x1f4c1, /* file folder */
+            "Failed to Open File",
+            "The requested file does not exist or is inaccessible. "
+            "Please check the file path." } },
+        { invalidHeader_GmStatusCode,
+          { 0x1f4a9, /* pile of poo */
+            "Invalid Header",
+            "The received header did not conform to the Gemini specification. "
+            "Perhaps the server is malfunctioning or you tried to contact a "
+            "non-Gemini server." } },
+        { invalidRedirect_GmStatusCode,
+          { 0, /*  */
+            "Invalid Redirect",
+            "The server responded with a redirect but did not provide a valid destination URL. "
+            "Perhaps the server is malfunctioning." } },
+        { temporaryFailure_GmStatusCode,
+          { 0x1f50c, /* electric plug */
+            "Temporary Failure",
+            "The request has failed, but may succeed if you try again in the future." } },
+        { serverUnavailable_GmStatusCode,
+          { 0x1f525, /* fire */
+            "Server Unavailable",
+            "The server is unavailable due to overload or maintenance. Check back later." } },
+        { cgiError_GmStatusCode,
+          { 0x1f4a5, /* collision */
+            "CGI Error",
+            "Failure during dynamic content generation on the server. This may be due "
+            "to buggy serverside software." } },
+        { proxyError_GmStatusCode,
+          { 0x1f310, /* globe */
+            "Proxy Error",
+            "A proxy request failed because the server was unable to successfully "
+            "complete a transaction with the remote host. Perhaps there are difficulties "
+            "with network connectivity." } },
+        { slowDown_GmStatusCode,
+          { 0x1f40c, /* snail */
+            "Slow Down",
+            "The server is rate limiting requests. Please wait..." } },
+        { permanentFailure_GmStatusCode,
+          { 0x1f6ab, /* no entry */
+            "Permanent Failure",
+            "Your request has failed and will fail in the future as well if repeated." } },
+        { notFound_GmStatusCode,
+          { 0x1f50d, /* magnifying glass */
+            "Not Found",
+            "The requested resource could not be found at this time." } },
+        { gone_GmStatusCode,
+          { 0x1f47b, /* ghost */
+            "Gone",
+            "The resource requested is no longer available and will not be available again." } },
+        { proxyRequestRefused_GmStatusCode,
+          { 0x1f6c2, /* passport control */
+            "Proxy Request Refused",
+            "The request was for a resource at a domain not served by the server and the "
+            "server does not accept proxy requests." } },
+        { badRequest_GmStatusCode,
+          { 0x1f44e, /* thumbs down */
+            "Bad Request",
+            "The server was unable to parse your request, presumably due to the "
+            "request being malformed. Likely a bug in Lagrange." } },
+        { clientCertificateRequired_GmStatusCode,
+          { 0x1f511, /* key */
+            "Certificate Required",
+            "Access to the requested resource requires identification via "
+            "a client certificate." } },
+        { certificateNotAuthorized_GmStatusCode,
+          { 0x1f512, /* lock */
+            "Certificate Not Authorized",
+            "The provided client certificate is valid but is not authorized for accessing "
+            "the requested resource. " } },
+        { certificateNotValid_GmStatusCode,
+          { 0x1f6a8, /* revolving light */
+            "Invalid Certificate",
+            "The provided client certificate is expired or invalid." } },
+    };
+    iForIndices(i, errors) {
+        if (errors[i].code == code) {
+            return &errors[i].err;
+        }
+    }
+    return &none;
+}