box-node-sdk
Version:
Official SDK for Box Plaform APIs
195 lines • 9.51 kB
JavaScript
"use strict";
/**
* @fileoverview Manager for the Box Collaboration Allowlist Resource
*/
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
var url_path_1 = __importDefault(require("../util/url-path"));
// -----------------------------------------------------------------------------
// Typedefs
// -----------------------------------------------------------------------------
/**
* Collaboration Allowlist parameter constant
* @typedef {string} CollaborationAllowlistDirection Determines the type of restriction for allowlisting for a domain
*/
var CollaborationAllowlistDirection;
(function (CollaborationAllowlistDirection) {
CollaborationAllowlistDirection["INBOUND"] = "inbound";
CollaborationAllowlistDirection["OUTBOUND"] = "outbound";
CollaborationAllowlistDirection["BOTH"] = "both";
})(CollaborationAllowlistDirection || (CollaborationAllowlistDirection = {}));
// ------------------------------------------------------------------------------
// Private
// ------------------------------------------------------------------------------
var BASE_PATH = '/collaboration_whitelist_entries', TARGET_ENTRY_PATH = '/collaboration_whitelist_exempt_targets';
// ------------------------------------------------------------------------------
// Public
// ------------------------------------------------------------------------------
/**
* Simple manager for interacting with all 'Collaboration Allowlist' endpoints and actions.
*
* @constructor
* @param {BoxClient} client - The Box API Client that is responsible for making calls to the API
* @returns {void}
*/
var CollaborationAllowlist = /** @class */ (function () {
function CollaborationAllowlist(client) {
this.client = client;
}
/**
* Add a domain to the enterprise's allowlist.
*
* API Endpoint: '/collaboration_whitelist_entries'
* Method: POST
*
* @param {string} domain - The domain to be added to the allowlist
* @param {CollaborationAllowlistDirection} direction - Inbound refers to collaboration actions within an enterprise. Outbound
* refers to collaboration actions external to an enterprise. Both refers to
* collaboration actions taken within and external to an enterprise
* @param {Function} [callback] - Passed the collaboration allowlist information if it was created successfully
* @returns {Promise<Object>} A promise resolve to the collaboration allowlist object
*/
CollaborationAllowlist.prototype.addDomain = function (domain, direction, callback) {
var params = {
body: {
domain: domain,
direction: direction,
},
};
var apiPath = (0, url_path_1.default)(BASE_PATH);
return this.client.wrapWithDefaultHandler(this.client.post)(apiPath, params, callback);
};
/**
* Requests a collaboration allowlist entry with a given ID.
*
* API Endpoint: '/collaboration_whitelist_entries/:domainID'
* Method: GET
*
* @param {string} domainID - Box ID of the collaboration allowlist being requested
* @param {Object} [options] - Additional options for the request. Can be left null in most cases.
* @param {Function} [callback] - Passed the collaboration allowlist information if it was acquired successfully
* @returns {Promise<Object>} A promise resolving to the collaboration allowlist object
*/
CollaborationAllowlist.prototype.getAllowlistedDomain = function (domainID, options, callback) {
var params = { qs: options };
var apiPath = (0, url_path_1.default)(BASE_PATH, domainID);
return this.client.wrapWithDefaultHandler(this.client.get)(apiPath, params, callback);
};
/**
* Requests all collaboration allowlist entries within an enterprise.
*
* API Endpoint: '/collaboration_whitelist_entries'
* Method: GET
*
* @param {Object} [options] - Additional options. Can be left null in most cases.
* @param {int} [options.limit] - The number of collaboration allowlists to retrieve
* @param {string} [options.marker] - Paging marker, retrieve records starting at this position in the list. Left blank to start at the beginning.
* @param {Function} [callback] - Passed a list of collaboration allowlists if successful, error otherwise
* @returns {Promise<Object>} A promise resolving to the collection of collaboration allowlists
*/
CollaborationAllowlist.prototype.getAllAllowlistedDomains = function (options, callback) {
var params = {
qs: options,
};
var apiPath = (0, url_path_1.default)(BASE_PATH);
return this.client.wrapWithDefaultHandler(this.client.get)(apiPath, params, callback);
};
/**
* Delete a given collaboration allowlist entry.
*
* API Endpoint: '/collaboration_whitelist_entries/:domainID'
* Method: DELETE
*
* @param {string} domainID - Box ID of the collaboration allowlist being requested
* @param {Function} [callback] - Empty response body passed if successful.
* @returns {Promise<void>} A promise resolving to nothing
*/
CollaborationAllowlist.prototype.removeDomain = function (domainID, callback) {
var apiPath = (0, url_path_1.default)(BASE_PATH, domainID);
return this.client.wrapWithDefaultHandler(this.client.del)(apiPath, null, callback);
};
/**
* Adds a Box User to the exempt target list.
*
* API Endpoint: '/collaboration_whitelist_exempt_targets'
* Method: GET
*
* @param {string} userID - The ID of the Box User to be added to the allowlist
* @param {Function} [callback] - Passed a collaboration allowlist for user if successful, error otherwise
* @returns {Promise<Object>} A promise resolving to a user collaboration allowlist
*/
CollaborationAllowlist.prototype.addExemption = function (userID, callback) {
var params = {
body: {
user: {
id: userID,
type: 'user',
},
},
};
var apiPath = (0, url_path_1.default)(TARGET_ENTRY_PATH);
return this.client.wrapWithDefaultHandler(this.client.post)(apiPath, params, callback);
};
/**
* Retrieves information about a collaboration allowlist for user by allowlist ID.
*
* API Endpoint: '/collaboration_whitelist_exempt_targets/:exemptionID'
* Method: GET
*
* @param {string} exemptionID - The ID of the collaboration allowlist
* @param {Object} [options] - Additional options for the request. Can be left null in most cases.
* @param {Function} [callback] - Passed the collaboration allowlist information for a user if it was acquired successfully
* @returns {Promise<Object>} A promise resolving to the collaboration allowlist object
*/
CollaborationAllowlist.prototype.getExemption = function (exemptionID, options, callback) {
var params = {
qs: options,
};
var apiPath = (0, url_path_1.default)(TARGET_ENTRY_PATH, exemptionID);
return this.client.wrapWithDefaultHandler(this.client.get)(apiPath, params, callback);
};
/**
* Retrieve a list of all exemptions to an enterprise's collaboration allowlist.
*
* API Endpoint: '/collaboration_whitelist_exempt_targets'
* Method: GET
*
* @param {Object} [options] - Additional options. Can be left null in most cases.
* @param {int} [options.limit] - The number of user collaboration allowlists to retrieve
* @param {string} [options.marker] - Paging marker, retrieve records starting at this position in the list. Left blank to start at the beginning.
* @param {Function} [callback] - Passed a list of user collaboration allowlists if successful, error otherwise
* @returns {Promise<Object>} A promise resolving to the collection of user collaboration allowlists
*/
CollaborationAllowlist.prototype.getAllExemptions = function (options, callback) {
var params = {
qs: options,
};
var apiPath = (0, url_path_1.default)(TARGET_ENTRY_PATH);
return this.client.wrapWithDefaultHandler(this.client.get)(apiPath, params, callback);
};
/**
* Delete a given user collaboration allowlist.
*
* API Endpoint: '/collaboration_whitelist_exempt_targets/:exemptionID'
* Method: DELETE
*
* @param {string} exemptionID - Box ID of the user collaboration allowlist being requested
* @param {Function} [callback] - Empty response body passed if successful.
* @returns {Promise<void>} A promise resolving to nothing
*/
CollaborationAllowlist.prototype.removeExemption = function (exemptionID, callback) {
var apiPath = (0, url_path_1.default)(TARGET_ENTRY_PATH, exemptionID);
return this.client.wrapWithDefaultHandler(this.client.del)(apiPath, null, callback);
};
return CollaborationAllowlist;
}());
/**
* Enum of valid collaboration allowlist directions
*
* @readonly
* @enum {CollaborationAllowlistDirection}
*/
CollaborationAllowlist.prototype.directions = CollaborationAllowlistDirection;
module.exports = CollaborationAllowlist;
//# sourceMappingURL=collaboration-allowlist.js.map