@contentstack/management
Version:
The Content Management API is used to manage the content of your Contentstack account
244 lines (239 loc) • 9.31 kB
JavaScript
;
var _interopRequireDefault3 = require("@babel/runtime/helpers/interopRequireDefault");
var _interopRequireDefault2 = _interopRequireDefault3(require("@babel/runtime/helpers/interopRequireDefault"));
Object.defineProperty(exports, "__esModule", {
value: true
});
var _typeof2 = require("@babel/runtime/helpers/typeof");
var _typeof3 = (0, _interopRequireDefault2["default"])(_typeof2);
var _asyncToGenerator2 = require("@babel/runtime/helpers/asyncToGenerator");
var _asyncToGenerator3 = (0, _interopRequireDefault2["default"])(_asyncToGenerator2);
exports.Extension = Extension;
exports.ExtensionCollection = ExtensionCollection;
exports.createExtensionFormData = createExtensionFormData;
var _regenerator = require("@babel/runtime/regenerator");
var _regenerator2 = (0, _interopRequireDefault2["default"])(_regenerator);
var _cloneDeep = require("lodash/cloneDeep");
var _cloneDeep2 = (0, _interopRequireDefault2["default"])(_cloneDeep);
var _entity = require("../../entity");
var _contentstackError = require("../../core/contentstackError");
var _contentstackError2 = (0, _interopRequireDefault2["default"])(_contentstackError);
var _formData = require("form-data");
var _formData2 = (0, _interopRequireDefault2["default"])(_formData);
var _fs = require("fs");
/**
* Extensions let you create custom fields and custom widgets that lets you customize Contentstack's default UI and behavior. Read more about <a href='https://www.contentstack.com/docs/developers/about-experience-extensions/'>Extensions</a>.
* @namespace Extension
* */
function Extension(http) {
var data = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
this.stackHeaders = data.stackHeaders;
this.urlPath = "/extensions";
if (data.extension) {
Object.assign(this, (0, _cloneDeep2["default"])(data.extension));
this.urlPath = "/extensions/".concat(this.uid);
/**
* @description The Update Extension call lets you update an existing Extension.
* @memberof Extension
* @func update
* @returns {Promise<Extension>} Promise for Extension instance.
* @example
* import * as contentstack from '@contentstack/management'
* const client = contentstack.client()
*
* client.stack({ api_key: 'api_key'}).extension('extension_uid').fetch()
* .then((extension) => {
* extension.title = 'My Extension Type'
* return extension.update()
* })
* .then((extension) => console.log(extension))
*
*/
this.update = (0, _entity.update)(http, 'extension');
/**
* @description The Delete Extension call is used to delete an existing Extension permanently from your Stack.
* @memberof Extension
* @func delete
* @returns {Promise<Object>} Response Object.
* @example
* import * as contentstack from '@contentstack/management'
* const client = contentstack.client()
*
* client.stack({ api_key: 'api_key'}).extension('extension_uid').delete()
* .then((response) => console.log(response.notice))
*/
this["delete"] = (0, _entity.deleteEntity)(http);
/**
* @description The fetch Extension call fetches Extension details.
* @memberof Extension
* @func fetch
* @returns {Promise<Extension>} Promise for Extension instance
* @example
* import * as contentstack from '@contentstack/management'
* const client = contentstack.client()
*
* client.stack({ api_key: 'api_key'}).extension('extension_uid').fetch()
* .then((extension) => console.log(extension))
*
*/
this.fetch = (0, _entity.fetch)(http, 'extension');
} else {
/**
* @description The Upload is used to upload a new custom widget, custom field, dashboard Widget to a stack.
* @memberof Extension
* @func upload
* @async
* @param {Object} data - Extension data object.
* @param {Object=} params - Optional query parameters.
* @returns {Promise<Extension>} Promise for Extension instance
*
* @example
* import * as contentstack from '@contentstack/management'
* const client = contentstack.client()
*
* const extension = {
* upload: 'path/to/file',
* tags: [
* 'tag1',
* 'tag2'
* ],
* data_type: 'text',
* multiple: false,
* config: {},
* type: 'Type of extension you want to create widget/dashboard/field'
* }
*
* client.stack({ api_key: 'api_key'}).extension().upload(extension)
* .then((extension) => console.log(extension))
*/
this.upload = /*#__PURE__*/function () {
var _ref = (0, _asyncToGenerator3["default"])(/*#__PURE__*/_regenerator2["default"].mark(function _callee(data, params) {
var response, _t;
return _regenerator2["default"].wrap(function (_context) {
while (1) switch (_context.prev = _context.next) {
case 0:
_context.prev = 0;
_context.next = 1;
return (0, _entity.upload)({
http: http,
urlPath: this.urlPath,
stackHeaders: this.stackHeaders,
formData: createExtensionFormData(data),
params: params
});
case 1:
response = _context.sent;
if (!response.data) {
_context.next = 2;
break;
}
return _context.abrupt("return", new this.constructor(http, (0, _entity.parseData)(response, this.stackHeaders)));
case 2:
throw (0, _contentstackError2["default"])(response);
case 3:
_context.next = 5;
break;
case 4:
_context.prev = 4;
_t = _context["catch"](0);
throw (0, _contentstackError2["default"])(_t);
case 5:
case "end":
return _context.stop();
}
}, _callee, this, [[0, 4]]);
}));
return function (_x, _x2) {
return _ref.apply(this, arguments);
};
}();
/**
* @description The Create a extension call creates a new extension in a particular stack of your Contentstack account.
* @memberof Extension
* @func create
* @returns {Promise<Extension>} Promise for Extension instance
*
* @example
* import * as contentstack from '@contentstack/management'
* const client = contentstack.client()
* const extension = {
* tags: [
* 'tag1',
* 'tag2'
* ],
* data_type: 'text',
* title: 'Old Extension',
* src: "Enter either the source code (use 'srcdoc') or the external hosting link of the extension depending on the hosting method you selected.",
* multiple: false,
* config: {},
* type: 'field'
* }
*
* client.stack().extension().create({ extension })
* .then((extension) => console.log(extension))
*/
this.create = (0, _entity.create)({
http: http
});
/**
* @description The Query on Extension will allow you to fetch details of all or specific Extensions.
* @memberof Extension
* @func query
* @param {Object} params - URI parameters
* @prop {Object} params.query - Queries that you can use to fetch filtered results for extensions.
* @returns {Object} Query builder object with find(), count(), and findOne() methods.
*
* @example
* import * as contentstack from '@contentstack/management'
* const client = contentstack.client()
*
* client.stack().extension().query({ query: { type: "field" } }).find()
* .then((extensions) => console.log(extensions))
*/
this.query = (0, _entity.query)({
http: http,
wrapperCollection: ExtensionCollection
});
}
}
function ExtensionCollection(http, data) {
var obj = (0, _cloneDeep2["default"])(data.extensions) || [];
var extensionCollection = obj.map(function (extensiondata) {
return new Extension(http, {
extension: extensiondata,
stackHeaders: data.stackHeaders
});
});
return extensionCollection;
}
function createExtensionFormData(data) {
return function () {
var formData = new _formData2["default"]();
if (typeof data.title === 'string') {
formData.append('extension[title]', data.title);
}
if ((0, _typeof3["default"])(data.scope) === 'object') {
formData.append('extension[scope]', "".concat(data.scope));
}
if (typeof data['data_type'] === 'string') {
formData.append('extension[data_type]', data['data_type']);
}
if (typeof data.type === 'string') {
formData.append('extension[type]', data.type);
}
if (data.tags instanceof Array) {
formData.append('extension[tags]', data.tags.join(','));
} else if (typeof data.tags === 'string') {
formData.append('extension[tags]', data.tags);
}
if (typeof data.multiple === 'boolean') {
formData.append('extension[multiple]', "".concat(data.multiple));
}
if (typeof data.enable === 'boolean') {
formData.append('extension[enable]', "".concat(data.enable));
}
var uploadStream = (0, _fs.createReadStream)(data.upload);
formData.append('extension[upload]', uploadStream);
return formData;
};
}