Stash Client - Stedi SDK for JavaScript

@stedi/sdk-client-stash

Description

Stedi Stash SDK for JavaScript.

Stash API specification.

For more information, read the Getting Started Guide.

All API endpoints are POST operations and any parameters must be fully contained in the request body.

Installing

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

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

Getting Started

Initialize the client

First, create a new StashClient.

import { StashClient, CreateKeyspaceCommand } from "@stedi/sdk-client-stash";

const client = new StashClient({
  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 CreateKeyspaceCommand.

import { StashClient, CreateKeyspaceCommand } from "@stedi/sdk-client-stash";

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

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

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