eg001CreateRoomWithData.js

/**
 * @file
 * Example 001: Create Room With Data
 * @author DocuSign
 */

const path = require('path')
    , docusignRooms = require('docusign-rooms')
    , validator = require('validator')
    , dsConfig = require('../../config/index.js').config
    ;

const eg001CreateRoomWithData = exports
    , eg = 'eg001rooms' // This example reference.
    , mustAuthenticate = '/ds/mustAuthenticate'
    , minimumBufferMin = 3
    ;

/**
 * Create room
 * @param {object} req Request obj
 * @param {object} res Response obj
 */
eg001CreateRoomWithData.createController = async (req, res) => {
    // Check the token
    // At this point we should have a good token. But we
    // double-check here to enable a better UX to the user.
    let tokenOK = req.dsAuth.checkToken(minimumBufferMin);
    if (!tokenOK) {
        req.flash('info', 'Sorry, you need to re-authenticate.');
        // Save the current operation so it will be resumed after authentication
        req.dsAuth.setEg(req, eg);
        res.redirect(mustAuthenticate);
    }
    console.log('token', req.user.accessToken)
    // Call the worker method
    let body = req.body
        // Additional data validation 
        , roomName = validator.escape(body.roomName)
        , roomsWithDataArgs = {
            roomName: roomName
        }
        , args = {
            accessToken: req.user.accessToken,
            basePath: req.session.basePath,
            accountId: req.session.accountId,
            roomsWithDataArgs: roomsWithDataArgs
        }
        , results = null
        ;

    try {
        results = await eg001CreateRoomWithData.worker(args)
    }
    catch (error) {
        let errorBody = error && error.response && error.response.body
            // we can pull the DocuSign error code and message from the response body
            , errorCode = errorBody && errorBody.errorCode
            , errorMessage = errorBody && errorBody.message
            ;
        // In production, may want to provide customized error messages and
        // remediation advice to the user.
        res.render('pages/error', { err: error, errorCode: errorCode, errorMessage: errorMessage });
    }

    if (results) {
        res.render('pages/example_done', {
            title: "The room was successfully created",
            h1: "The room was successfully created",
            message: `The room was created! Room ID: ${results.roomId}, Name: ${results.name}.`
        });
    }
}

/**
 * This function does creation of the room with data
 * @param {object} args
 */
eg001CreateRoomWithData.worker = async (args) => {

    // Step 2 start
    let dsApiClient = new docusignRooms.ApiClient();
    dsApiClient.setBasePath(`${dsConfig.roomsApiUrl}/restapi`);
    dsApiClient.addDefaultHeader('Authorization', 'Bearer ' + args.accessToken);
    // Step 2 end

    let roomsApi = new docusignRooms.RoomsApi(dsApiClient)
        , results = null;
    let rolesApi = new docusignRooms.RolesApi(dsApiClient)
        , rolesResult = null;

    rolesResult = await rolesApi.getRoles(args.accountId);
    args.roomsWithDataArgs.roleId = rolesResult.roles[0].roleId;

    // Step 3-1 start
    let roomWithData = makeRoomsWithData(args.roomsWithDataArgs)
    // Step 3-1 end

    // Step 4 start
    results = await roomsApi.createRoom(args.accountId, roomWithData, null);
    // Step 4 end

    console.log(`Room with data was created. RoomId ${results.roomId}`);
    return results;
}

// Step 3-2 start
function makeRoomsWithData(args) {
    return {
        body: {
            name: args.roomName,
            roleId: args.roleId,
            transactionSideId: "listbuy",
            fieldData: {
                data: {
                    address1: '123 EZ Street',
                    address2: 'unit 10',
                    city: 'Galaxian',
                    state: 'US-HI',
                    postalCode: '11112',
                    companyRoomStatus: '5',
                    comments: `Lorem ipsum dolor sit amet, consectetur adipiscing elit, 
                    sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. 
                    Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
                    nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in 
                    reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla 
                    pariatur. Excepteur sint occaecat cupidatat non proident, sunt in 
                    culpa qui officia deserunt mollit anim id est laborum.`
                }
            }
        }
    }
}
// Step 3-2 end

/**
 * Form page for this application
 */
eg001CreateRoomWithData.getController = (req, res) => {
    // Check that the authentication token is ok with a long buffer time.
    // If needed, now is the best time to ask the user to authenticate
    // since they have not yet entered any information into the form.
    let tokenOK = req.dsAuth.checkToken();
    if (tokenOK) {
        res.render('pages/rooms-examples/eg001CreateRoomWithData', {
            eg: eg, csrfToken: req.csrfToken(),
            title: "Create Room with Data",
            sourceFile: path.basename(__filename),
            sourceUrl: dsConfig.githubRoomsExampleUrl + path.basename(__filename),
            documentation: dsConfig.documentation + eg,
            showDoc: dsConfig.documentation
        });
    } else {
        // Save the current operation so it will be resumed after authentication
        req.dsAuth.setEg(req, eg);
        res.redirect(mustAuthenticate);
    }
}