Introducing (#1)

* Fetches data from a GitHub API endpoint, handling pagination.

* Makes an HTTP PUT request to a GitHub API endpoint.

* Performs an HTTP DELETE request to a GitHub API endpoint.

* Makes an HTTP POST request to a GitHub API endpoint.

* Creates an options object for HTTP requests to the GitHub API.

* Apps Script JSON

Author: rmottanet

GithubHttpApp/appsscript.json

@@ -0,0 +1,7 @@
+{
+  "timeZone": "America/Sao_Paulo",
+  "dependencies": {
+  },
+  "exceptionLogging": "STACKDRIVER",
+  "runtimeVersion": "V8"
+}

GithubHttpApp/deleter.js

@@ -0,0 +1,21 @@
+/**
+ * Performs an HTTP DELETE request to a GitHub API endpoint.
+ *
+ * @param {string} GH_TOKEN - The GitHub access token.
+ * @param {string} URL - The URL of the endpoint to which the request will be sent.
+ * @returns {Object} A response object from the `UrlFetchApp.fetch` function.
+ * @throws {Error} Throws an exception if an error occurs during the request.
+ */
+async function deleter(GH_TOKEN, URL) {
+
+  const options = getHttpOptions('DELETE', GH_TOKEN);
+  
+  try {
+    
+    return UrlFetchApp.fetch(URL, options);
+    
+  } catch (error) {
+      Logger.log('Error deleting: ' + error);
+    throw error;
+  }
+}

GithubHttpApp/fetcher.js

@@ -0,0 +1,39 @@
+/**
+ * Fetches data from a GitHub API endpoint, handling pagination.
+ *
+ * @param {string} GH_TOKEN - The GitHub access token.
+ * @param {string} URL - The URL of the GitHub API endpoint to fetch data from.
+ * @returns {Promise<Array<Object>>} A promise that resolves to an array of data objects fetched from the API.
+ */
+async function fetcher(GH_TOKEN, URL) {
+  
+  const options = getHttpOptions('GET', GH_TOKEN);
+
+  const allData = [];
+  
+  let page = 1;
+
+  while (true) {
+    
+    const pageUrl = `${URL}?page=${page}`;
+
+    const response = await UrlFetchApp.fetch(pageUrl, options);
+
+    if (response.getResponseCode() !== 200) {
+      throw new Error(`API request failed with status ${response.getResponseCode()}: ${response.getContentText()}`);
+    }
+
+    const data = JSON.parse(response.getContentText());
+    
+    if (data.length === 0) {
+      break;
+    }
+
+    allData.push(...data);
+    page++;
+    
+  }
+  
+  return allData;
+  
+}

GithubHttpApp/poster.js

@@ -0,0 +1,22 @@
+/**
+ * Makes an HTTP POST request to a GitHub API endpoint.
+ *
+ * @param {string} GGH_TOKEN - The GitHub access token.
+ * @param {string} URL - The URL of the endpoint to which the request will be sent.
+ * @param {object} payload - The request payload, which will be converted to JSON and included in the request body.
+ * @returns {Object} A response object from the `UrlFetchApp.fetch` function.
+ * @throws {Error} Throws an exception if an error occurs during the request.
+ */
+async function poster(GH_TOKEN, URL, payload) {
+  
+  const options = getHttpOptions('POST', GH_TOKEN, payload);
+
+  try {
+
+    return UrlFetchApp.fetch(URL, options);
+    
+  } catch (error) {
+      Logger.log('Error posting: ' + error);
+    throw error;
+  }
+}

GithubHttpApp/putter.js

@@ -0,0 +1,22 @@
+/**
+ * Makes an HTTP PUT request to a GitHub API endpoint.
+ *
+ * @param {string} GH_TOKEN - The GitHub access token.
+ * @param {string} URL - The URL of the endpoint to which the request will be sent.
+ * @param {object} payload - The request payload, which will be converted to JSON and included in the request body.
+ * @returns {Object} A response object from the `UrlFetchApp.fetch` function.
+ * @throws {Error} Throws an exception if an error occurs during the request.
+ */
+async function putter(GH_TOKEN, URL, payload) {
+
+  const options = getHttpOptions('PUT', GH_TOKEN, payload);
+
+  try {
+
+    return UrlFetchApp.fetch(URL, options);
+    
+  } catch (error) {
+      Logger.log('Error putting: ' + error);
+    throw error;
+  }
+}

GithubHttpApp/utils/getHttpOptions.js

@@ -0,0 +1,33 @@
+/**
+ * Creates an options object for HTTP requests to the GitHub API.
+ *
+ * @param {string} method - The HTTP method to use (e.g., 'GET', 'POST', 'PUT', 'DELETE').
+ * @param {string} GH_TOKEN - The access token for the GitHub API.
+ * @param {object} [payload] - The request payload, which will be converted to JSON and included in the request body.
+ * @returns {object} An options object to be used with `UrlFetchApp.fetch`.
+ * @throws {Error} Throws an error if the payload is not an object.
+ *
+ */
+function getHttpOptions(method, GH_TOKEN, payload = null) {
+  
+  const baseOptions = {
+    'headers': {
+      'Accept': 'application/vnd.github+json',
+      'Authorization': `Bearer ${GH_TOKEN}`,
+      'X-GitHub-Api-Version': '2022-11-28',
+    },
+    'method': method,
+  };
+
+  if (payload) {
+    // Ensure payload is an object and handle potential errors
+    if (typeof payload !== 'object' || payload === null) {
+      throw new Error('Invalid payload format. Payload must be an object.');
+    }
+
+    // Convert non-string values to strings for correct JSON serialization
+    baseOptions.payload = JSON.stringify(payload);
+  }
+
+  return baseOptions;
+}