@authress/sdk/src/userPermissionsApi.js

Client SDK for Authress authorization as a service. Provides managed authorization api to secure service resources including user data.

const { URL, URLSearchParams } = require('url');

const ArgumentRequiredError = require('./argumentRequiredError');
const UnauthorizedError = require('./unauthorizedError');

class UserPermissionsApi {
  constructor(client) {
    this.client = client;
  }

  async authorizeUser(userId, resourceUri, permission) {
    // verify required parameter 'userId' is not null or undefined
    if (userId === null || userId === undefined) {
      throw new ArgumentRequiredError('userId', 'Required parameter userId was null or undefined when calling authorizeUser.');
    }
    // verify required parameter 'resourceUri' is not null or undefined
    if (resourceUri === null || resourceUri === undefined) {
      throw new ArgumentRequiredError('resourceUri', 'Required parameter resourceUri was null or undefined when calling authorizeUser.');
    }
    // verify required parameter 'permission' is not null or undefined
    if (permission === null || permission === undefined) {
      throw new ArgumentRequiredError('permission', 'Required parameter permission was null or undefined when calling authorizeUser.');
    }
    const url = `/v1/users/${encodeURIComponent(String(userId))}/resources/${encodeURIComponent(String(resourceUri))}/permissions/${encodeURIComponent(String(permission))}`;
    try {
      const response = await this.client.get(url);
      return response;
    } catch (error) {
      if (error.status === 404) {
        throw new UnauthorizedError(userId, resourceUri, permission);
      }
      throw error;
    }
  }

  async disableUserToken(userId, tokenId) {
    // verify required parameter 'userId' is not null or undefined
    if (userId === null || userId === undefined) {
      throw new ArgumentRequiredError('userId', 'Required parameter userId was null or undefined when calling disableUserToken.');
    }
    // verify required parameter 'tokenId' is not null or undefined
    if (tokenId === null || tokenId === undefined) {
      throw new ArgumentRequiredError('tokenId', 'Required parameter tokenId was null or undefined when calling disableUserToken.');
    }
    const url = `/v1/users/${encodeURIComponent(String(userId))}/tokens/${encodeURIComponent(String(tokenId))}`;
    const response = await this.client.delete(url);
    return response;
  }

  async getUserPermissionsForResource(userId, resourceUri) {
    // verify required parameter 'userId' is not null or undefined
    if (userId === null || userId === undefined) {
      throw new ArgumentRequiredError('userId', 'Required parameter userId was null or undefined when calling getUserPermissionsForResource.');
    }
    // verify required parameter 'resourceUri' is not null or undefined
    if (resourceUri === null || resourceUri === undefined) {
      throw new ArgumentRequiredError('resourceUri', 'Required parameter resourceUri was null or undefined when calling getUserPermissionsForResource.');
    }

    const url = `/v1/users/${encodeURIComponent(String(userId))}/resources/${encodeURIComponent(String(resourceUri))}/permissions`;
    const response = await this.client.get(url);
    return response;
  }

  async getUserRolesForResource(userId, resourceUri) {
    if (userId === null || userId === undefined) {
      throw new ArgumentRequiredError('userId', 'Required parameter userId was null or undefined when calling getUserRolesForResource.');
    }
    // verify required parameter 'resourceUri' is not null or undefined
    if (resourceUri === null || resourceUri === undefined) {
      throw new ArgumentRequiredError('resourceUri', 'Required parameter resourceUri was null or undefined when calling getUserRolesForResource.');
    }

    const url = `/v1/users/${encodeURIComponent(String(userId))}/resources/${encodeURIComponent(String(resourceUri))}/roles`;
    const response = await this.client.get(url);
    return response;
  }

  async getUserResources(userId, resourceUri, limit, cursor, permission, collectionConfiguration) {
    // verify required parameter 'userId' is not null or undefined
    if (userId === null || userId === undefined) {
      throw new ArgumentRequiredError('userId', 'Required parameter userId was null or undefined when calling getUserResources.');
    }

    const url = new URL(`${this.client.baseUrl}/v1/users/${encodeURIComponent(String(userId))}/resources`);
    const qs = { resourceUri };
    if (limit) { qs.limit = limit; }
    if (cursor) { qs.cursor = cursor; }
    if (permission) { qs.permissions = permission; }
    if (collectionConfiguration) { qs.collectionConfiguration = collectionConfiguration; }
    url.search = new URLSearchParams(qs).toString();

    const response = await this.client.get(url);
    return response;
  }
}

module.exports = UserPermissionsApi;