@stedi/sdk-client-as2

Description

Stedi As2 SDK for JavaScript.

Installing

To install the this package, simply type add or install @stedi/sdk-client-as2 using your favorite package manager:

npm install @stedi/sdk-client-as2
yarn add @stedi/sdk-client-as2
pnpm add @stedi/sdk-client-as2

Getting Started

Initialize the client

First, create a new As2Client.

import { As2Client, CreateAgreementCommand } from "@stedi/sdk-client-as2";

const client = new As2Client({
  region: "us",
  apiKey: "my-api-key",
});

Usage

Once the client is initiated, you may use it to send multiple commands. If you are using a custom http handler, you may call destroy() to close open connections.

Create a command by creating a new CreateAgreementCommand.

import { As2Client, CreateAgreementCommand } from "@stedi/sdk-client-as2";

const client = new As2Client({
  region: "us",
  apiKey: "my-api-key",
});

const params = {
  /** input parameters */
};

const command = new CreateAgreementCommand(params);

try {
  const data = await client.send(command);
  // process data.
} catch (error) {
  // error handling.
} finally {
  // finally.
}

Troubleshooting

When the service returns an exception, the error will include the exception information, as well as response metadata (e.g. request id).

try {
  const data = await client.send(command);
  // process data.
} catch (error) {
  const { requestId, cfId, extendedRequestId } = error.$metadata;
  console.log({ requestId, cfId, extendedRequestId });
  /**
   * The keys within exceptions are also parsed.
   * You can access them by checking if it is a certain instance of exception:
   * if (error instanceof SomeServiceException) {
   *     const value = error.specialKeyInException;
   * }
   */
}