import { strict as assert } from 'assert' import { noop } from './mocks' /** * Grants the given permissions to the given origin, using the given permissions * controller. * * Just a wrapper for an rpc-cap middleware function. * * @param {PermissionsController} permController - The permissions controller. * @param {string} origin - The origin to grant permissions to. * @param {Object} permissions - The permissions to grant. */ export function grantPermissions (permController, origin, permissions) { permController.permissions.grantNewPermissions( origin, permissions, {}, noop, ) } /** * Returns a wrapper for the given permissions controller's requestUserApproval * function, so we don't have to worry about its internals. * * @param {PermissionsController} permController - The permissions controller. * @return {Function} A convenient wrapper for the requestUserApproval function. */ export function getRequestUserApprovalHelper (permController) { /** * Returns a request object that can be passed to requestUserApproval. * * @param {string} id - The internal permissions request ID (not the RPC request ID). * @param {string} [origin] - The origin of the request, if necessary. * @returns {Object} The corresponding request object. */ return (id, origin = 'defaultOrigin') => { return permController.permissions.requestUserApproval({ metadata: { id, origin } }) } } /** * Returns a Promise that resolves once a pending user approval has been set. * Calls the underlying requestUserApproval function as normal, and restores it * once the Promise is resolved. * * This function must be called on the permissions controller for each request. * * @param {PermissionsController} - A permissions controller. * @returns {Promise} A Promise that resolves once a pending approval * has been set. */ export function getUserApprovalPromise (permController) { const originalFunction = permController.permissions.requestUserApproval return new Promise((resolveHelperPromise) => { permController.permissions.requestUserApproval = (req) => { const userApprovalPromise = originalFunction(req) permController.permissions.requestUserApproval = originalFunction resolveHelperPromise() return userApprovalPromise } }) } /** * Validates an activity log entry with respect to a request, response, and * relevant metadata. * * @param {Object} entry - The activity log entry to validate. * @param {Object} req - The request that generated the entry. * @param {Object} [res] - The response for the request, if any. * @param {'restricted'|'internal'} methodType - The method log controller method type of the request. * @param {boolean} success - Whether the request succeeded or not. */ export function validateActivityEntry ( entry, req, res, methodType, success, ) { assert.doesNotThrow( () => { _validateActivityEntry( entry, req, res, methodType, success, ) }, 'should have expected activity entry', ) } function _validateActivityEntry ( entry, req, res, methodType, success, ) { assert.ok(entry, 'entry should exist') assert.equal(entry.id, req.id) assert.equal(entry.method, req.method) assert.equal(entry.origin, req.origin) assert.equal(entry.methodType, methodType) assert.deepEqual( entry.request, req, 'entry.request should equal the request', ) if (res) { assert.ok( ( Number.isInteger(entry.requestTime) && Number.isInteger(entry.responseTime) ), 'request and response times should be numbers', ) assert.ok( (entry.requestTime <= entry.responseTime), 'request time should be less than response time', ) assert.equal(entry.success, success) assert.deepEqual( entry.response, res, 'entry.response should equal the response', ) } else { assert.ok( Number.isInteger(entry.requestTime) && entry.requestTime > 0, 'entry should have non-zero request time', ) assert.ok( ( entry.success === null && entry.responseTime === null && entry.response === null ), 'entry response values should be null', ) } }