UNPKG

baasic-sdk-javascript

Version:

JavaScript SDK provides core functionality for building web and mobile applications on [Baasic](http://www.baasic.com/).

100 lines (99 loc) 5.56 kB
/** * @module articleACLClient * @description Article ACL Client provides an easy way to consume Articles REST API end-points. In order to obtain needed routes `articleACLClient` uses `articleACLRoute`. */ import { IACLPolicy, IACLOptions } from '../../common/contracts'; import { ApiClient, IHttpResponse } from '../../httpApi'; import { ArticleACLRoute } from './'; export declare class ArticleACLClient { protected articleACLRoute: ArticleACLRoute; protected apiClient: ApiClient; readonly routeDefinition: ArticleACLRoute; constructor(articleACLRoute: ArticleACLRoute, apiClient: ApiClient); /** * Returns a promise that is resolved once the get action has been performed. Success response returns a list of ACL policies established for the specified article resource. * @method * @example articleACLClient.get({id: '<article-id>'}) .then(function (data) { // perform success action here }, function (response, status, headers, config) { // perform error handling here }); **/ get(options: IACLOptions): PromiseLike<IHttpResponse<IACLPolicy[]>>; /** * Returns a promise that is resolved once the update acl action has been performed, this action creates new ACL policy for the specified article resource. * @method * @param options An ACL policy object that needs to be updated in the system. This object specifies parameters necessary for establishing user and/or role set of rights. * @returns A promise that is resolved once the update acl action has been performed. * @example let options = {id : '<article-id>'}; let aclObj = { actionId: '<action-id'>, roleId: '<roleId>', userId: '<userId>' }; options[baasicConstants.modelPropertyName] = aclObj; articleACLClient.update(options) .then(function (data) { // perform success action here }, function (response, status, headers, config) { // perform error handling here }); **/ update(options: IACLOptions): PromiseLike<IHttpResponse<IACLPolicy[]>>; /** * Returns a promise that is resolved once the removeByUser action has been performed. This action deletes ACL policy assigned to the specified user and article resource. * @method * @param articleId Article id which uniquely identifies article resource whose security privileges need to be retrieved and updated. * @param action Action abbreviation which identifies ACL policy assigned to the specified user and article resource. * Supported Values: * "Create" * "Delete" * "Read" * "Update" * @param user A value that uniquely identifies user for which ACL policy needs to be removed. * @param data An ACL policy object that needs to be updated in the system. * @returns A promise that is resolved once the removeByUser action has been performed. * @example articleACLClient.removeByUser('<article-id>', '<access-action>', '<username>') .then(function (data) { // perform success action here }, function (response, status, headers, config) { // perform error handling here }); **/ removeByUser(articleId: string, action: string, user: string, data: IACLPolicy): PromiseLike<IHttpResponse<void>>; /** * Returns a promise that is resolved once the removeByRole action has been performed. This action deletes ACL policy assigned to the specified role and article resource. * @method * @param articleId Article id which uniquely identifies article resource whose security privileges need to be retrieved and updated. * @param action Action abbreviation which identifies ACL policy assigned to the specified user and article resource. * Supported Values: * "Create" * "Delete" * "Read" * "Update" * @param role A value that uniquely identifies role for which ACL policy needs to be removed. * @param data An ACL policy object that needs to be updated in the system. * @returns A promise that is resolved once the removeByRole action has been performed. * @example articleACLClient.removeByRole('<article-id>', '<access-action>', '<role-name>') .then(function (data) { // perform success action here }, function (response, status, headers, config) { // perform error handling here }); **/ removeByRole(articleId: string, action: string, role: string, data: IACLPolicy): PromiseLike<IHttpResponse<void>>; } /** * @copyright (c) 2017 Mono Ltd * @license MIT * @author Mono Ltd * @overview ***Notes:** - Refer to the [Baasic REST API](http://dev.baasic.com/api/reference/home) for detailed information about available Baasic REST API end-points. - All end-point objects are transformed by the associated route service. */