@stedi/sdk-client-tokens

Description

Stedi Tokens SDK for JavaScript.

Service to exchange IAM credentials for Stedi JWT token

Installing

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

• npm install @stedi/sdk-client-tokens
• yarn add @stedi/sdk-client-tokens
• pnpm add @stedi/sdk-client-tokens

Getting Started

Initialize the client

First, create a new TokensClient.

import { TokensClient, GetTokenForIAMCommand } from "@stedi/sdk-client-tokens";

const client = new TokensClient({
  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 GetTokenForIAMCommand.

import { TokensClient, GetTokenForIAMCommand } from "@stedi/sdk-client-tokens";

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

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

const command = new GetTokenForIAMCommand(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;
   * }
   */
}

License

This SDK is distributed under the Apache License, Version 2.0, see LICENSE for more information.

Client Commands (Operations List)

Command API Reference / Input / Output