@aws-sdk/types

What is @aws-sdk/types?

The @aws-sdk/types package provides TypeScript definitions for the AWS SDK for JavaScript v3. These types define the shapes of AWS service clients, commands, input and output parameters, and other utility types that are used across the AWS SDK. This package is essential for TypeScript developers using the AWS SDK as it enables type checking and IntelliSense support in IDEs.

What are @aws-sdk/types's main functionalities?

Service Client Interface

Defines the configuration interface for an AWS service client, such as the S3 client. It extends from a base client configuration and includes service-specific options.

{"interface S3ClientConfig extends SmithyClientConfig {endpoint?: HttpEndpoint, forcePathStyle?: boolean, useAccelerateEndpoint?: boolean, ...}}

Command Interface

Represents a command interface that defines input and output types for a specific operation. It also includes methods for resolving middleware in the command's execution stack.

{"interface Command<InputType extends object, OutputType extends object, ResolvedClientConfiguration, ClientInput extends InputType = InputType, ClientOutput extends OutputType = OutputType> {resolveMiddleware(stack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: ResolvedClientConfiguration): Handler<ClientInput, ClientOutput>; ...}}

Middleware Stack

Defines the middleware stack interface used in the AWS SDK. Middleware are functions that can modify requests and responses or handle specific tasks like logging or error handling.

{"interface MiddlewareStack<Input extends object, Output extends object> {add(middleware: MiddlewareType<Input, Output>, options?: MiddlewareStackOptions): void; addRelativeTo(middleware: MiddlewareType<Input, Output>, options: RelativeMiddlewareOptions): void; ...}}

Other packages similar to @aws-sdk/types

@google-cloud/common

Provides types and utility functions for Google Cloud client libraries for Node.js. Similar to @aws-sdk/types, it offers TypeScript definitions but for Google Cloud services.

azure-sdk-for-js

The Azure SDK for JavaScript provides TypeScript type definitions for Azure services. It is analogous to @aws-sdk/types but tailored for Microsoft Azure's cloud services.

@types/node

This package contains type definitions for Node.js. While not specific to a cloud provider, it serves a similar purpose by providing TypeScript types for Node.js core modules, much like @aws-sdk/types does for AWS SDK.

README

@aws-sdk/types

Changelog

3.654.0 (2024-09-18)

Bug Fixes

• codegen: fix setting of default signing name (#6487) (108bb99)
• middleware-flexible-checksums: use union for new config types (#6489) (c43103f)

Features

• client-cost-explorer: This release extends the GetReservationPurchaseRecommendation API to support recommendations for Amazon DynamoDB reservations. (6976388)
• client-directory-service-data: Added new AWS Directory Service Data API, enabling you to manage data stored in AWS Directory Service directories. This includes APIs for creating, reading, updating, and deleting directory users, groups, and group memberships. (8c9372b)
• client-directory-service: Added new APIs for enabling, disabling, and describing access to the AWS Directory Service Data API (cca80dd)
• client-guardduty: Add launchType and sourceIPs fields to GuardDuty findings. (13c3582)
• client-mailmanager: Introduce a new RuleSet condition evaluation, where customers can set up a StringExpression with a MimeHeader condition. This condition will perform the necessary validation based on the X-header provided by customers. (900a39e)
• client-s3: Added SSE-KMS support for directory buckets. (a00b8b0)