From 15b36727ffd57e06a3e0a0944c590f6cbb9c75b3 Mon Sep 17 00:00:00 2001
From: Bucky Wolfe <igneous@usleep.consulting>
Date: Tue, 12 May 2020 12:42:14 +0700
Subject: [PATCH 1/2] Add upload webhook that fires after tus afterComplete

---
 lib/endpoints.js | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/lib/endpoints.js b/lib/endpoints.js
index 0494306..40d5e3e 100644
--- a/lib/endpoints.js
+++ b/lib/endpoints.js
@@ -283,6 +283,14 @@ app.use('/files',
     afterComplete: (req, upload, fid) => {
       db.add(upload.metadata.sid, upload.metadata.key, upload);
       debug(`Completed upload ${ fid }, size=${ upload.size } name=${ upload.metadata.name }`);
+
+      // Trigger fileUploadedWebhook
+      if (config.fileUploadedWebhook) {
+        axios.post(config.fileUploadedWebhook, {
+          metadata: upload.metadata,
+          date: Date.now()
+        }).catch(err => console.error(err));
+      };
     },
   })
 );

From 23b298e05ae4229012c9aa911e84242da84083e8 Mon Sep 17 00:00:00 2001
From: Bucky Wolfe <igneous@usleep.consulting>
Date: Tue, 12 May 2020 17:14:16 +0700
Subject: [PATCH 2/2] Document webhooks

---
 config.js             | 10 ++++++----
 docs/configuration.md | 41 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 4 deletions(-)

diff --git a/config.js b/config.js
index c305697..c5f074f 100644
--- a/config.js
+++ b/config.js
@@ -41,11 +41,13 @@ const config =  {
   // see https://github.com/expressjs/morgan
   // set to false to disable logging
   "accessLog": ':date[iso] :method :url :status :response-time :remote-addr',
-  //use to set custom  upload url
+  // use to set custom upload url
   "uploadAppPath": '/',
-  // download notification webhook
-  // invokes an HTTP POST to this url whenever a file was downloaded
-  "fileDownloadedWebhook": null
+  // event webhooks
+  // invokes an HTTP POST to a url whenever a file is downloaded
+  // for more info, see the webhooks section of docs/configuration.md
+  "fileDownloadedWebhook": null,
+  "fileUploadedWebhook": null
 };
 
 
diff --git a/docs/configuration.md b/docs/configuration.md
index f99ef54..a41072c 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -47,3 +47,44 @@ For native SSL support provide `sslPort`, `sslKeyFile`, `sslCertFile` options. T
 a _snake oil_ certificate use `openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout cert.key -out cert.pem`.
 
 To disable HTTP set the `port` config value to `false`.
+
+## WebHooks
+
+For the sake of integrating PsiTransfer with other systems, PsiTransfer can notify a webhook with a POST request on the following events:
+
+### fileUploaded
+
+On completion of a file upload, if `fileUploadedWebhook` is set in `config.<NODE_ENV>.js`, PsiTransfer will make a POST request to that url.
+
+At the time of writing, the POST body will contain a data structure resembling this (serialized as json):
+```json
+{
+  "metadata": {
+    "sid": "6055ab792b6c",
+    "retention": 3600,
+    "password": "file password is in plaintext here",
+    "name": "test.png",
+    "comment": "User individual file comment goes here",
+    "type": "image/png",
+    "key": "135a3814-df46-4e23-b061-03bdda13425c",
+    "createdAt": 1589276618052
+  },
+  "date": 1589276619385
+}
+```
+
+* Note: this event will fire many times if a user uploads multiple files in a single session (`sid`), as each individual file is uploaded separately. You'll notice that the `sid` will remain the same, but the `key` will change for each file. 
+  * For file sync purposes (e.g. syncing client uploads to another service or long-term storage), you can reassemble a file fetch url with `https://<PSITRANSFER_HOST>/${sid}++${key}`
+
+### fileDownloaded
+
+When a user attempts to download a file, if `fileDownloadedWebhook` is set in `config.<NODE_ENV>.js`, PsiTransfer will make a POST request to that url.
+
+At the time of writing, the POST body will contain a data structure resembling this (serialized as json):
+```json
+{
+   "sid": "6055ab792b6c",
+   "name": "test.png",
+   "date": 1589276619415
+}
+```