box-node-sdk
Version:
Official SDK for Box Plaform APIs
97 lines • 4.73 kB
JavaScript
"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
const url_path_1 = __importDefault(require("../util/url-path"));
/**
* Simple manager for interacting with all Sign Requests endpoints and actions.
*/
class SignRequestsManager {
/**
* @param {BoxClient} client The Box API Client that is responsible for making calls to the API
*/
constructor(client) {
this.client = client;
}
/**
* Get Box Sign request by ID
*
* Gets a sign request by ID.
* @param {object} options Options for the request
* @param {string} options.sign_request_id The ID of the signature request
* @param {Function} [callback] Passed the result if successful, error otherwise
* @returns {Promise<schemas.SignRequest>} A promise resolving to the result or rejecting with an error
*/
getById(options, callback) {
const { sign_request_id: signRequestId, ...queryParams } = options, apiPath = (0, url_path_1.default)('sign_requests', signRequestId), params = {
qs: queryParams,
};
return this.client.wrapWithDefaultHandler(this.client.get)(apiPath, params, callback);
}
/**
* List Box Sign requests
*
* Gets signature requests created by a user. If the `sign_files` and/or
* `parent_folder` are deleted, the signature request will not return in the list.
* @param {object} [options] Options for the request
* @param {string} [options.marker] Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires `usemarker` to be set to `true`.
* @param {number} [options.limit] The maximum number of items to return per page.
* @param {Function} [callback] Passed the result if successful, error otherwise
* @returns {Promise<schemas.SignRequests>} A promise resolving to the result or rejecting with an error
*/
getAll(options, callback) {
const { ...queryParams } = options, apiPath = (0, url_path_1.default)('sign_requests'), params = {
qs: queryParams,
};
return this.client.wrapWithDefaultHandler(this.client.get)(apiPath, params, callback);
}
/**
* Create Box Sign request
*
* Creates a signature request. This involves preparing a document for signing and
* sending the signature request to signers.
* @param {schemas.SignRequestCreateRequest} body
* @param {object} [options] Options for the request
* @param {Function} [callback] Passed the result if successful, error otherwise
* @returns {Promise<schemas.SignRequest>} A promise resolving to the result or rejecting with an error
*/
create(body, options, callback) {
const { ...queryParams } = options, apiPath = (0, url_path_1.default)('sign_requests'), params = {
qs: queryParams,
body: body,
};
return this.client.wrapWithDefaultHandler(this.client.post)(apiPath, params, callback);
}
/**
* Cancel Box Sign request
*
* Cancels a sign request.
* @param {object} options Options for the request
* @param {string} options.sign_request_id The ID of the signature request
* @param {Function} [callback] Passed the result if successful, error otherwise
* @returns {Promise<schemas.SignRequest>} A promise resolving to the result or rejecting with an error
*/
cancelById(options, callback) {
const { sign_request_id: signRequestId, ...queryParams } = options, apiPath = (0, url_path_1.default)('sign_requests', signRequestId, 'cancel'), params = {
qs: queryParams,
};
return this.client.wrapWithDefaultHandler(this.client.post)(apiPath, params, callback);
}
/**
* Resend Box Sign request
*
* Resends a signature request email to all outstanding signers.
* @param {object} options Options for the request
* @param {string} options.sign_request_id The ID of the signature request
* @param {Function} [callback] Passed the result if successful, error otherwise
* @returns {Promise<void>} A promise resolving to the result or rejecting with an error
*/
resendById(options, callback) {
const { sign_request_id: signRequestId, ...queryParams } = options, apiPath = (0, url_path_1.default)('sign_requests', signRequestId, 'resend'), params = {
qs: queryParams,
};
return this.client.wrapWithDefaultHandler(this.client.post)(apiPath, params, callback);
}
}
module.exports = SignRequestsManager;
//# sourceMappingURL=sign-requests.generated.js.map