@ucp-npm/mx-adapter

MX Adapter for the UCW

This is the adapter that makes it possible to connect with MX via the Universal Connect Widget.

Installation

This package is meant to be used with the Universal Connect Widget. If you have forked the UCW project, you can install it as a dependency of the widget.

Navigate to your forked project and, from the root of the project, run:

npm i @ucp-npm/mx-adapter --workspace apps/server

Usage

Once you have the npm package installed, you can set up the ucw to use it.

In the ./apps/server/adapterSetup.ts file, do the following:

Import the adapterMapObject for mx:

import { getMxAdapterMapObject as mxAdapterMapObject } from "@ucp-npm/mx-adapter";

Also import the cache client, and logger:

import { get, set } from "./services/storageClient/redis";
import * as logger from "./infra/logger";

Next, look for the line that starts with export const adapterMap = {, and add the adapter map as follows:

export const adapterMap = {
  ...mxAdapterMapObject({
    cacheClient: {
      set: set,
      get: get,
    },
    logClient: logger,
    aggregatorCredentials: {
      mxInt: {
        username: config.MxClientId,
        password: config.MxApiSecret,
        basePath: 'https://int-api.mx.com',
        vcEndpoint: 'https://int-api.mx.com/',
        aggregator: 'mx_int',
        available: true
      },
      mxProd: {
        username: config.MxClientIdProd,
        password: config.MxApiSecretProd,
        basePath: 'https://api.mx.com',
        vcEndpoint: 'https://api.mx.com/',
        aggregator: 'mx',
        available: true
      },
    },
    envConfig: {
      HOSTURL: config.HOSTURL
    },
  }),
  ...testAdapterMapObject,
};

The dependencies cacheClient and logClient are provided by the Universal Connect Widget.

Published NPM Package

https://www.npmjs.com/package/@ucp-npm/mx-adapter

More Info

See https://universalconnectproject.org/ for more information.