@c2c-platform/sdk-server v1.0.6

C2C Platform - SDK Server

Installation

Install the package from npm repository

$ npm install @c2c-platform/sdk-server

Features

• Products Api
  • Get Product info
  • Update Product
• Roles Api
  • Find Roles
  • Get Role
  • Get Role By Code
  • Create Role
  • Update Role
  • Delete Role
  • Assign Permissions To Role
  • Remove Permissions From Role
• Users Api
  • Find Users
  • Get User
  • Get User By Email
  • Invite User
  • Update User
  • Delete User
  • Assign Roles To User
  • Remove Roles From User
  • Archive User
  • Unarchive User
• Multiple Languages
• Verify Token / Check Permission
  • Verify Token
  • Check Permission

Usage / Examples

Usage of SDK

import { Platform } from '@c2c-platform/sdk-server'

// Initialize the platform instance
const platform = new Platform({
  baseUrl: 'https://api-admin.scrum-dev.com',
  clientId: '6385aff93780bfb6a84d85b9',
  clientSecret: '9290993cce5eb4ba6fedafb7894de720'
});

// use the methods to interactive with api server
await platform.product.updateProduct(...)

API Reference

Product Api

getProductInfo(options)

// example
try {
  const result = await platform.product.getProductInfo({ headers : { acceptLanguage: 'ja' } });
} catch (err) {
  console.log(err);
}

// or
platform.product.getProductInfo({ headers : { acceptLanguage: 'ja' } }).then((result) => console.log(result));

updateProduct(data, options)

// example
const data: IUpdateProductInput = {
  name: 'Product Example',
  logo: 'https://example.com/static/logo.svg',
  domain: 'example.com',
  auth0: {
    tokenExpire: 3600,
    refreshTokenExpire: 3600,
    loginCallbackUrl: ['https://example.com/login/callback'],
    logoutCallbackUrl: ['https://example.com'];
  }
};

try {
  const result = await platform.product.updateProduct(data, { headers : { acceptLanguage: 'ja' } });
} catch (err) {
  console.log(err);
}

// or
platform.product.updateProduct(data, { headers : { acceptLanguage: 'ja' } }).then((result) => console.log(result));

Role Api

findRoles(params, options)

// example
try {
  const result = await platform.role.findRoles({ keyword: 'example', skip: 0, limit: 50 }, { headers : { acceptLanguage: 'ja' } });
} catch (err) {
  console.log(err);
}

// or
platform.role.findRoles({ keyword: 'keyword' })
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

getRole(id, options)

// example
try {
  const result = await platform.role.getRole('{roleid}');
} catch (err) {
  console.log(err);
}

//or
platform.role.getRole('{roleid}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

getRoleByCode(id, options)

// example
try {
  const result = await platform.role.getRoleByCode('{roleCode}');
} catch (err) {
  console.log(err);
}

//or
platform.role.getRoleByCode('{roleCode}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

createRole(data, options)

// example
try {
  const result = await platform.role.createRole({
    name: 'Example',
    code: 'example',
    isRoot: false,
    level: 2,
  })
} catch (err) {
  console.log(err);
}

// or
const result = await platform.role.createRole({
  name: 'Example',
  code: 'example',
  isRoot: false,
  level: 2,
}).then((result) => console.log(result)).catch((err) => console.log(err));

updateRole(id, data, options)

try {
  const result = await platform.role.updateRole('{roleid}', {
    name: 'Example Revised',
    code: 'example',
  });
} catch (err) {
  console.log(err);
}

// or
const result = await platform.role.updateRole('{roleid}', {
  name: 'Example Revised',
  code: 'example',
}).then((result) => console.log(result)).catch((err) => console.log(err));

deleteRole(id, options)

// example
try {
  const result = await platform.role.deleteRole('{roleid}');
} catch (err) {
  console.log(err);
}

// or
platform.role.deleteRole('{roleid}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

assignPermissions(id, permissions, options)

// example
try {
  const result = await platform.role.assignPermissions('{roleid}', ['read:user', 'update:user']);
} catch (err) {
  console.log(err);
}

// or
platform.role.assignPermissions('{roleid}', ['read:user', 'update:user'])
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

unassignPermissions(id, permissions, options)

// example
try {
  const result = await platform.role.unassignPermissions('{roleid}', ['read:user', 'update:user']);
} catch (err) {
  console.log(err);
}

// or
platform.role.unassignPermissions('{roleid}', ['read:user', 'update:user'])
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

User Api

findUsers(params, options)

// example
try {
  const result = await platform.user.findUsers({ keyword: 'keyword', status: 'activated', skip: 0, limit: 50 });
} catch (err) {
  console.log(err);
}

// or
platform.user.findUsers({ keyword: 'keyword', status: 'activated', skip: 0, limit: 50 })
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

getUser(id, options)

// example
try {
  const result = await platform.user.getUser('{userId}');
} catch (err) {
  console.log(err);
}

// or
platform.user.getUser('{userId}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

getUserByEmail(email, options)

// example
try {
  const result = await platform.user.getUserByEmail('{email}');
} catch (err) {
  console.log(err);
}

// or
platform.user.getUserByEmail('{email}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

inviteUser(data, options)

// example
try {
  const result = await platform.user.inviteUser({
    email: 'user@example.com',
    roleIds: ['roleId1', 'roleId2'],
  });
} catch (err) {
  console.log(err);
}

// or
platform.user.inviteUser({
    email: 'user@example.com',
    roleIds: ['roleId1', 'roleId2'],
})
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

updateUser(id, data, options)

// example
try {
  const result = await platform.user.updateUser({
    firstName: 'First name',
    lastName: 'Last name',
    metadata: {},
  });
} catch (err) {
  console.log(err);
}

// or
platform.user.updateUser({
  firstName: 'First name',
  lastName: 'Last name',
  metadata: {},
})
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

deleteUser(id, options)

// example
try {
  const result = await platform.user.deleteUser('{userId}');
} catch (err) {
  console.log(err);
}

// or
platform.user.deleteUser('{userId}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

assignRoles(id, roleIds, options)

// example
try {
  const result = await platform.user.assignRoles('{userId}', ['{roleId01}', '{roleId02}']);
} catch (err) {
  console.log(err);
}

// or
platform.user.assignRoles('{userId}', ['{roleId01}', '{roleId02}'])
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

unassignRoles(id, roleIds, options)

// example
try {
  const result = await platform.user.unassignRoles('{userId}', ['{roleId01}', '{roleId02}']);
} catch (err) {
  console.log(err);
}

// or
platform.user.unassignRoles('{userId}', ['{roleId01}', '{roleId02}'])
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

archiveUser(id, options)

// example
try {
  const result = await platform.user.archiveUser('{userId}');
} catch (err) {
  console.log(err);
}

// or
platform.user.archiveUser('{userId}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

unarchiveUser(id, options)

// example
try {
  const result = await platform.user.unarchiveUser('{userId}');
} catch (err) {
  console.log(err);
}

// or
platform.user.unarchiveUser('{userId}')
  .then((result) => console.log(result))
  .catch((err) => console.log(err));

Multiple Languages

You can setup the default languages by the options once initialize the platform like below

// Initialize the platform class with clientId and secretKey values
const platform = new Platform({
  baseUrl: 'https://api-admin.scrum-dev.com',
  clientId: '6385aff93780bfb6a84d85b9',
  clientSecret: '9290993cce5eb4ba6fedafb7894de720',
  defaultLanguage: 'ja'
});;

Or, set the specified language by the api option param once executing the method (this usage is higher priority)

try {
  const result = await platform.product.updateProduct(data, { headers : { acceptLanguage: 'ja' } });
} catch (err) {
  console.log(err);
}

Verify Token / Check Permission

These are functions for verifying and checking the permission from the Auth0 token. 

verifyToken(token, secret)

// for example
import { verifyToken } from '@c2c-platform/sdk-server';

// verify token
const data = verifyToken('{JWT}', '{JWT_SECRET}');
console.log(data)

hasPermission(data, permission)

// for example
import { verifyToken, hasPermission } from '@c2c-platform/sdk-server';

// verify token
const authenticatedData = verifyToken('{JWT}', '{JWT_SECRET}');
console.log(authenticatedData)

// Checking the permissions
const result = hasPermission(authenticatedData, 'update:user', 'read:user');
console.log(result)