00F - Internal crawler, database, and API

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2018 Blue Link Labs
+Copyright (c) 2019 Blue Link Labs
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -43,7 +43,10 @@ await beakerCore.setup({
     exportAPI(apiName, apiManifest, apiImpl, [guardFn])
   },
   downloadsWebAPI: {...},
-  browserWebAPI: {...}
+  browserWebAPI: {...},
+  userSessionAPI: {
+    getFor(webContents) {/*...*/}
+  }
 })
 
 // setup the protocol handler
@@ -115,6 +118,10 @@ debug('dat-related stuff')
 
 ### `dat.debug`
 
+### `crawler`
+
+### `users`
+
 ## API (@beaker/core/webview)
 
 ### `setup()`

applications.js

@@ -0,0 +1,69 @@
+const sessionPerms = require('./lib/session-perms')
+const knex = require('./lib/knex')
+const db = require('./dbs/profile-data-db')
+const sitedataDb = require('./dbs/sitedata')
+const dat = require('./dat')
+
+// typedefs
+// =
+
+/**
+ * @typedef {Object} ApplicationPermission
+ * @prop {string} id
+ * @prop {string[]} caps
+ * @prop {string} description
+ *
+ * @typedef {Object} ApplicationState
+ * @prop {string} url
+ * @prop {ApplicationPermission[]} permissions
+ * @prop {boolean} installed
+ * @prop {boolean} enabled
+ * @prop {string} installedAt
+ */
+
+// exported api
+// =
+
+/**
+ * @param {Object} opts
+ * @param {number} opts.userId
+ * @param {string} opts.url
+ * @returns {Promise<ApplicationState>}
+ */
+exports.getApplicationState = async function ({userId, url}) {
+  url = await dat.library.getPrimaryUrl(url)
+  var record = await db.get(knex('installed_applications').where({userId, url}))
+  if (record) {
+    record.installed = true
+  } else {
+    record = {
+      url,
+      installed: false,
+      enabled: false,
+      installedAt: null
+    }
+  }
+  record.permissions = await sitedataDb.getAppPermissions(record.url)
+  return massageAppRecord(record)
+}
+
+// internal methods
+// =
+
+/**
+ * @param {Object} record
+ * @returns {ApplicationState}
+ */
+function massageAppRecord (record) {
+  return {
+    url: record.url,
+    permissions: Object.entries(record.permissions).map(([id, caps]) => ({
+      id,
+      caps,
+      description: sessionPerms.describePerm(id, caps)
+    })),
+    installed: record.installed,
+    enabled: Boolean(record.enabled),
+    installedAt: record.createdAt ? (new Date(record.createdAt)).toISOString() : null
+  }
+}