feat: create and use IpfsApiAccessError

add-on/src/lib/ipfs-proxy/api-access-error.js

@@ -0,0 +1,23 @@
+'use strict'
+/* eslint-env browser */
+
+
+/**
+ * An Error that indicates API access was somehow denied by the user
+ * @type {IpfsApiAccessError}
+ * @example
+ *   try {
+ *     await ipfs.files.add(Buffer.from('seed'))
+ *   } catch (err) {
+ *     if (err instanceof window.ipfs.types.IpfsApiAccessError) {
+ *       // API access was denied by the user
+ *     }
+ *   }
+ */
+export default class IpfsApiAccessError extends Error {
+  constructor (message, permission, scope) {
+    super(message)
+    this.permission = permission
+    this.scope = scope
+  }
+}

add-on/src/lib/ipfs-proxy/pre-acl.js

@@ -1,3 +1,5 @@
+const IpfsApiAccessError = require('./api-access-error')
+
 // This are the functions that DO NOT require an allow/deny decision by the user.
 // All other IPFS functions require authorization.
 const ACL_WHITELIST = Object.freeze(require('./acl-whitelist.json'))
@@ -21,7 +23,9 @@ function createPreAcl (permission, getState, getScope, accessControl, requestAcc
       access = await accessControl.setAccess(scope, wildcard ? '*' : permission, allow)
     }
 
-    if (!access.allow) throw new Error(`User denied access to ${permission}`)
+    if (!access.allow) {
+      throw new IpfsApiAccessError(`User denied access to ${permission}`, permission, scope)
+    }
 
     return args
   }

add-on/src/lib/ipfs-proxy/request-access.js

@@ -1,6 +1,7 @@
 'use strict'
 
 const { piggyback } = require('piggybacker')
+const IpfsApiAccessError = require('./api-access-error')
 
 const DIALOG_WIDTH = 540
 const DIALOG_HEIGHT = 220
@@ -98,7 +99,11 @@ function createRequestAccess (browser, screen) {
     const userTabRemoved = new Promise((resolve, reject) => {
       onTabRemoved = (id) => {
         if (id !== tabId) return
-        reject(new Error(`Failed to obtain access response for ${permission} at ${scope}`))
+        reject(new IpfsApiAccessError(
+          `Failed to obtain access response for ${permission} at ${scope}`,
+          permission,
+          scope
+        ))
       }
       browser.tabs.onRemoved.addListener(onTabRemoved)
     })