npm package: @stedi/sdk-client-tokens
Description: Stedi SDK for JavaScript that includes Tokens client for Node.js, Browser and React Native
Author: Stedi Team
Latest version: 0.4.78
Deprecated: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

<!-- generated file, do not edit directly -->

# @stedi/sdk-client-tokens

[![NPM version](https://img.shields.io/npm/v/@stedi/sdk-client-tokens/latest.svg)](https://www.npmjs.com/package/@stedi/sdk-client-tokens)
[![NPM downloads](https://img.shields.io/npm/dm/@stedi/sdk-client-tokens.svg)](https://www.npmjs.com/package/@stedi/sdk-client-tokens)
[![Stability Index](https://img.shields.io/badge/dynamic/json?color=yellow&url=https://unpkg.com/@stedi/sdk-client-tokens/package.json&query=$.stability&label=stability)](https://github.com/dominictarr/stability)
[![Minimum Node.js version](https://img.shields.io/badge/dynamic/json?color=brightgreen&url=https://unpkg.com/@stedi/sdk-client-tokens/package.json&query=$.engines.node&label=nodejs)](https://nodejs.org/)

## 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`.

```ts
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`.

```ts
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).

```js
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](http://www.apache.org/licenses/LICENSE-2.0),
see LICENSE for more information.

## Client Commands (Operations List)

<details>
<summary>
GetTokenForIAM
</summary>

[Command API Reference](/docs/sdk/clients/tokens/docs/classes/GetTokenForIAMCommand.html) / [Input](/docs/sdk/clients/tokens/docs/interfaces/GetTokenForIAMCommandInput.html) / [Output](/docs/sdk/clients/tokens/docs/interfaces/GetTokenForIAMCommandOutput.html)

</details>