@aws-sdk/types 3.212.0 → 3.222.0

package/dist-cjs/checksum.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/identity/AnonymousIdentity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/identity/AwsCredentialIdentity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/identity/Identity.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+;

package/dist-cjs/identity/LoginIdentity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/identity/TokenIdentity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-cjs/identity/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./AnonymousIdentity"), exports);
+tslib_1.__exportStar(require("./AwsCredentialIdentity"), exports);
+tslib_1.__exportStar(require("./Identity"), exports);
+tslib_1.__exportStar(require("./LoginIdentity"), exports);
+tslib_1.__exportStar(require("./TokenIdentity"), exports);

package/dist-cjs/index.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./abort"), exports);
 tslib_1.__exportStar(require("./auth"), exports);
+tslib_1.__exportStar(require("./checksum"), exports);
 tslib_1.__exportStar(require("./client"), exports);
 tslib_1.__exportStar(require("./command"), exports);
 tslib_1.__exportStar(require("./credentials"), exports);
@@ -10,11 +11,13 @@ tslib_1.__exportStar(require("./crypto"), exports);
 tslib_1.__exportStar(require("./endpoint"), exports);
 tslib_1.__exportStar(require("./eventStream"), exports);
 tslib_1.__exportStar(require("./http"), exports);
+tslib_1.__exportStar(require("./identity"), exports);
 tslib_1.__exportStar(require("./logger"), exports);
 tslib_1.__exportStar(require("./middleware"), exports);
 tslib_1.__exportStar(require("./pagination"), exports);
 tslib_1.__exportStar(require("./profile"), exports);
 tslib_1.__exportStar(require("./response"), exports);
+tslib_1.__exportStar(require("./retry"), exports);
 tslib_1.__exportStar(require("./serde"), exports);
 tslib_1.__exportStar(require("./shapes"), exports);
 tslib_1.__exportStar(require("./signature"), exports);

package/dist-cjs/retry.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist-es/checksum.js

@@ -0,0 +1 @@
+export {};

package/dist-es/identity/AnonymousIdentity.js

@@ -0,0 +1 @@
+export {};

package/dist-es/identity/AwsCredentialIdentity.js

@@ -0,0 +1 @@
+export {};

package/dist-es/identity/Identity.js

@@ -0,0 +1,2 @@
+;
+export {};

package/dist-es/identity/LoginIdentity.js

@@ -0,0 +1 @@
+export {};

package/dist-es/identity/TokenIdentity.js

@@ -0,0 +1 @@
+export {};

package/dist-es/identity/index.js

@@ -0,0 +1,5 @@
+export * from "./AnonymousIdentity";
+export * from "./AwsCredentialIdentity";
+export * from "./Identity";
+export * from "./LoginIdentity";
+export * from "./TokenIdentity";

package/dist-es/index.js

@@ -1,5 +1,6 @@
 export * from "./abort";
 export * from "./auth";
+export * from "./checksum";
 export * from "./client";
 export * from "./command";
 export * from "./credentials";
@@ -7,11 +8,13 @@ export * from "./crypto";
 export * from "./endpoint";
 export * from "./eventStream";
 export * from "./http";
+export * from "./identity";
 export * from "./logger";
 export * from "./middleware";
 export * from "./pagination";
 export * from "./profile";
 export * from "./response";
+export * from "./retry";
 export * from "./serde";
 export * from "./shapes";
 export * from "./signature";

package/dist-es/retry.js

@@ -0,0 +1 @@
+export {};

package/dist-types/checksum.d.ts

@@ -0,0 +1,50 @@
+/**
+ * An object that provides a checksum of data provided in chunks to `update`.
+ * The checksum may be performed incrementally as chunks are received or all
+ * at once when the checksum is finalized, depending on the underlying
+ * implementation.
+ *
+ * It's recommended to compute checksum incrementally to avoid reading the
+ * entire payload in memory.
+ *
+ * A class that implements this interface may accept an optional secret key in its
+ * constructor while computing checksum value, when using HMAC. If provided,
+ * this secret key would be used when computing checksum.
+ */
+export interface Checksum {
+    /**
+     * Constant length of the digest created by the algorithm in bytes.
+     */
+    digestLength?: number;
+    /**
+     * Creates a new checksum object that contains a deep copy of the internal
+     * state of the current `Checksum` object.
+     */
+    copy?(): Checksum;
+    /**
+     * Returns the digest of all of the data passed.
+     */
+    digest(): Promise<Uint8Array>;
+    /**
+     * Allows marking a checksum for checksums that support the ability
+     * to mark and reset.
+     *
+     * @param {number} readLimit - The maximum limit of bytes that can be read
+     *   before the mark position becomes invalid.
+     */
+    mark?(readLimit: number): void;
+    /**
+     * Resets the checksum to its initial value.
+     */
+    reset(): void;
+    /**
+     * Adds a chunk of data for which checksum needs to be computed.
+     * This can be called many times with new data as it is streamed.
+     *
+     * Implementations may override this method which passes second param
+     * which makes Checksum object stateless.
+     *
+     * @param {Uint8Array} chunk - The buffer to update checksum with.
+     */
+    update(chunk: Uint8Array): void;
+}

package/dist-types/credentials.d.ts

@@ -1,26 +1,13 @@
+import { AwsCredentialIdentity } from "./identity";
 import { Provider } from "./util";
-export interface AwsCredentialIdentity {
-    /**
-     * A {Date} when the identity or credential will no longer be accepted.
-     */
-    readonly expiration?: Date;
-}
 /**
  * An object representing temporary or permanent AWS credentials.
+ *
+ * @deprecated Use {@AwsCredentialIdentity}
  */
 export interface Credentials extends AwsCredentialIdentity {
-    /**
-     * AWS access key ID
-     */
-    readonly accessKeyId: string;
-    /**
-     * AWS secret access key
-     */
-    readonly secretAccessKey: string;
-    /**
-     * A security or session token to use with these credentials. Usually
-     * present for temporary credentials.
-     */
-    readonly sessionToken?: string;
 }
+/**
+ * @deprecated Use {@AwsCredentialIdentityProvider}
+ */
 export declare type CredentialProvider = Provider<Credentials>;

package/dist-types/crypto.d.ts

@@ -3,6 +3,8 @@ export declare type SourceData = string | ArrayBuffer | ArrayBufferView;
  * An object that provides a hash of data provided in chunks to `update`. The
  * hash may be performed incrementally as chunks are received or all at once
  * when the hash is finalized, depending on the underlying implementation.
+ *
+ * @deprecated use {@link Checksum}
  */
 export interface Hash {
     /**

package/dist-types/identity/AnonymousIdentity.d.ts

@@ -0,0 +1,3 @@
+import { Identity } from "./Identity";
+export interface AnonymousIdentity extends Identity {
+}

package/dist-types/identity/AwsCredentialIdentity.d.ts

@@ -0,0 +1,17 @@
+import { Identity, IdentityProvider } from "./Identity";
+export interface AwsCredentialIdentity extends Identity {
+    /**
+     * AWS access key ID
+     */
+    readonly accessKeyId: string;
+    /**
+     * AWS secret access key
+     */
+    readonly secretAccessKey: string;
+    /**
+     * A security or session token to use with these credentials. Usually
+     * present for temporary credentials.
+     */
+    readonly sessionToken?: string;
+}
+export declare type AwsCredentialIdentityProvider = IdentityProvider<AwsCredentialIdentity>;

package/dist-types/identity/Identity.d.ts

@@ -0,0 +1,9 @@
+export interface Identity {
+    /**
+     * A {Date} when the identity or credential will no longer be accepted.
+     */
+    readonly expiration?: Date;
+}
+export interface IdentityProvider<IdentityT extends Identity> {
+    (identityProperties?: Record<string, any>): Promise<IdentityT>;
+}

package/dist-types/identity/LoginIdentity.d.ts

@@ -0,0 +1,12 @@
+import { Identity, IdentityProvider } from "./Identity";
+export interface LoginIdentity extends Identity {
+    /**
+     * Identity username
+     */
+    readonly username: string;
+    /**
+     * Identity password
+     */
+    readonly password: string;
+}
+export declare type LoginIdentityProvider = IdentityProvider<LoginIdentity>;

package/dist-types/identity/TokenIdentity.d.ts

@@ -0,0 +1,8 @@
+import { Identity, IdentityProvider } from "./Identity";
+export interface TokenIdentity extends Identity {
+    /**
+     * The literal token string
+     */
+    readonly token: string;
+}
+export declare type TokenIdentityProvider = IdentityProvider<TokenIdentity>;

package/dist-types/identity/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./AnonymousIdentity";
+export * from "./AwsCredentialIdentity";
+export * from "./Identity";
+export * from "./LoginIdentity";
+export * from "./TokenIdentity";

package/dist-types/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./abort";
 export * from "./auth";
+export * from "./checksum";
 export * from "./client";
 export * from "./command";
 export * from "./credentials";
@@ -7,11 +8,13 @@ export * from "./crypto";
 export * from "./endpoint";
 export * from "./eventStream";
 export * from "./http";
+export * from "./identity";
 export * from "./logger";
 export * from "./middleware";
 export * from "./pagination";
 export * from "./profile";
 export * from "./response";
+export * from "./retry";
 export * from "./serde";
 export * from "./shapes";
 export * from "./signature";

package/dist-types/retry.d.ts

@@ -0,0 +1,112 @@
+export declare type RetryErrorType = 
+/**
+ * This is a connection level error such as a socket timeout, socket connect
+ * error, tls negotiation timeout etc...
+ * Typically these should never be applied for non-idempotent request types
+ * since in this scenario, it's impossible to know whether the operation had
+ * a side effect on the server.
+ */
+"TRANSIENT"
+/**
+ * This is an error where the server explicitly told the client to back off,
+ * such as a 429 or 503 Http error.
+ */
+ | "THROTTLING"
+/**
+ * This is a server error that isn't explicitly throttling but is considered
+ * by the client to be something that should be retried.
+ */
+ | "SERVER_ERROR"
+/**
+ * Doesn't count against any budgets. This could be something like a 401
+ * challenge in Http.
+ */
+ | "CLIENT_ERROR";
+export interface RetryErrorInfo {
+    errorType: RetryErrorType;
+    /**
+     * Protocol hint. This could come from Http's 'retry-after' header or
+     * something from MQTT or any other protocol that has the ability to convey
+     * retry info from a peer.
+     *
+     * @returns the Date after which a retry should be attempted.
+     */
+    retryAfterHint?: Date;
+}
+export interface RetryBackoffStrategy {
+    /**
+     * @returns the number of milliseconds to wait before retrying an action.
+     */
+    computeNextBackoffDelay(retryAttempt: number): number;
+}
+export interface StandardRetryBackoffStrategy extends RetryBackoffStrategy {
+    /**
+     * Sets the delayBase used to compute backoff delays.
+     * @param delayBase
+     */
+    setDelayBase(delayBase: number): void;
+}
+export interface RetryStrategyOptions {
+    backoffStrategy: RetryBackoffStrategy;
+    maxRetriesBase: number;
+}
+export interface RetryToken {
+    /**
+     * @returns the current count of retry.
+     */
+    getRetryCount(): number;
+    /**
+     * @returns the number of milliseconds to wait before retrying an action.
+     */
+    getRetryDelay(): number;
+}
+export interface StandardRetryToken extends RetryToken {
+    /**
+     * @returns wheather token has remaining tokens.
+     */
+    hasRetryTokens(errorType: RetryErrorType): boolean;
+    /**
+     * @returns the number of available tokens.
+     */
+    getRetryTokenCount(errorInfo: RetryErrorInfo): number;
+    /**
+     * @returns the cost of the last retry attemp.
+     */
+    getLastRetryCost(): number | undefined;
+    /**
+     * Releases a number of tokens.
+     *
+     * @param amount of tokens to release.
+     */
+    releaseRetryTokens(amount?: number): void;
+}
+export interface RetryStrategyV2 {
+    /**
+     * Called before any retries (for the first call to the operation). It either
+     * returns a retry token or an error upon the failure to acquire a token prior.
+     *
+     * tokenScope is arbitrary and out of scope for this component. However,
+     * adding it here offers us a lot of future flexibility for outage detection.
+     * For example, it could be "us-east-1" on a shared retry strategy, or
+     * "us-west-2-c:dynamodb".
+     */
+    acquireInitialRetryToken(retryTokenScope: string): Promise<RetryToken>;
+    /**
+     * After a failed operation call, this function is invoked to refresh the
+     * retryToken returned by acquireInitialRetryToken(). This function can
+     * either choose to allow another retry and send a new or updated token,
+     * or reject the retry attempt and report the error either in an exception
+     * or returning an error.
+     */
+    refreshRetryTokenForRetry(tokenToRenew: RetryToken, errorInfo: RetryErrorInfo): Promise<RetryToken>;
+    /**
+     * Upon successful completion of the operation, a user calls this function
+     * to record that the operation was successful.
+     */
+    recordSuccess(token: RetryToken): void;
+}
+export declare type ExponentialBackoffJitterType = "DEFAULT" | "NONE" | "FULL" | "DECORRELATED";
+export interface ExponentialBackoffStrategyOptions {
+    jitterType: ExponentialBackoffJitterType;
+    backoffScaleValue?: number;
+}

package/dist-types/token.d.ts

@@ -1,16 +1,13 @@
+import { TokenIdentity } from "./identity";
 import { Provider } from "./util";
 /**
  * An object representing temporary or permanent AWS token.
+ *
+ * @deprecated Use {@TokenIdentity}
  */
-export interface Token {
-    /**
-     *The literal token string
-     */
-    readonly token: string;
-    /**
-     * A {Date} when these token will no longer be accepted.
-     * When expiration is not defined, the token is assumed to be permanent.
-     */
-    readonly expiration?: Date;
+export interface Token extends TokenIdentity {
 }
+/**
+ * @deprecated Use {@TokenIdentityProvider}
+ */
 export declare type TokenProvider = Provider<Token>;

package/dist-types/ts3.4/checksum.d.ts

@@ -0,0 +1,8 @@
+export interface Checksum {
+  digestLength?: number;
+  copy?(): Checksum;
+  digest(): Promise<Uint8Array>;
+  mark?(readLimit: number): void;
+  reset(): void;
+  update(chunk: Uint8Array): void;
+}

package/dist-types/ts3.4/credentials.d.ts

@@ -1,10 +1,4 @@
+import { AwsCredentialIdentity } from "./identity";
 import { Provider } from "./util";
-export interface AwsCredentialIdentity {
-  readonly expiration?: Date;
-}
-export interface Credentials extends AwsCredentialIdentity {
-  readonly accessKeyId: string;
-  readonly secretAccessKey: string;
-  readonly sessionToken?: string;
-}
+export interface Credentials extends AwsCredentialIdentity {}
 export declare type CredentialProvider = Provider<Credentials>;

package/dist-types/ts3.4/identity/AnonymousIdentity.d.ts

@@ -0,0 +1,2 @@
+import { Identity } from "./Identity";
+export interface AnonymousIdentity extends Identity {}

package/dist-types/ts3.4/identity/AwsCredentialIdentity.d.ts

@@ -0,0 +1,8 @@
+import { Identity, IdentityProvider } from "./Identity";
+export interface AwsCredentialIdentity extends Identity {
+  readonly accessKeyId: string;
+  readonly secretAccessKey: string;
+  readonly sessionToken?: string;
+}
+export declare type AwsCredentialIdentityProvider =
+  IdentityProvider<AwsCredentialIdentity>;

package/dist-types/ts3.4/identity/Identity.d.ts

@@ -0,0 +1,6 @@
+export interface Identity {
+  readonly expiration?: Date;
+}
+export interface IdentityProvider<IdentityT extends Identity> {
+  (identityProperties?: Record<string, any>): Promise<IdentityT>;
+}

package/dist-types/ts3.4/identity/LoginIdentity.d.ts

@@ -0,0 +1,6 @@
+import { Identity, IdentityProvider } from "./Identity";
+export interface LoginIdentity extends Identity {
+  readonly username: string;
+  readonly password: string;
+}
+export declare type LoginIdentityProvider = IdentityProvider<LoginIdentity>;

package/dist-types/ts3.4/identity/TokenIdentity.d.ts

@@ -0,0 +1,5 @@
+import { Identity, IdentityProvider } from "./Identity";
+export interface TokenIdentity extends Identity {
+  readonly token: string;
+}
+export declare type TokenIdentityProvider = IdentityProvider<TokenIdentity>;

package/dist-types/ts3.4/identity/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./AnonymousIdentity";
+export * from "./AwsCredentialIdentity";
+export * from "./Identity";
+export * from "./LoginIdentity";
+export * from "./TokenIdentity";

package/dist-types/ts3.4/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./abort";
 export * from "./auth";
+export * from "./checksum";
 export * from "./client";
 export * from "./command";
 export * from "./credentials";
@@ -7,11 +8,13 @@ export * from "./crypto";
 export * from "./endpoint";
 export * from "./eventStream";
 export * from "./http";
+export * from "./identity";
 export * from "./logger";
 export * from "./middleware";
 export * from "./pagination";
 export * from "./profile";
 export * from "./response";
+export * from "./retry";
 export * from "./serde";
 export * from "./shapes";
 export * from "./signature";

package/dist-types/ts3.4/retry.d.ts

@@ -0,0 +1,46 @@
+export declare type RetryErrorType =
+  | "TRANSIENT"
+  | "THROTTLING"
+  | "SERVER_ERROR"
+  | "CLIENT_ERROR";
+export interface RetryErrorInfo {
+  errorType: RetryErrorType;
+  retryAfterHint?: Date;
+}
+export interface RetryBackoffStrategy {
+  computeNextBackoffDelay(retryAttempt: number): number;
+}
+export interface StandardRetryBackoffStrategy extends RetryBackoffStrategy {
+  setDelayBase(delayBase: number): void;
+}
+export interface RetryStrategyOptions {
+  backoffStrategy: RetryBackoffStrategy;
+  maxRetriesBase: number;
+}
+export interface RetryToken {
+  getRetryCount(): number;
+  getRetryDelay(): number;
+}
+export interface StandardRetryToken extends RetryToken {
+  hasRetryTokens(errorType: RetryErrorType): boolean;
+  getRetryTokenCount(errorInfo: RetryErrorInfo): number;
+  getLastRetryCost(): number | undefined;
+  releaseRetryTokens(amount?: number): void;
+}
+export interface RetryStrategyV2 {
+  acquireInitialRetryToken(retryTokenScope: string): Promise<RetryToken>;
+  refreshRetryTokenForRetry(
+    tokenToRenew: RetryToken,
+    errorInfo: RetryErrorInfo
+  ): Promise<RetryToken>;
+  recordSuccess(token: RetryToken): void;
+}
+export declare type ExponentialBackoffJitterType =
+  | "DEFAULT"
+  | "NONE"
+  | "FULL"
+  | "DECORRELATED";
+export interface ExponentialBackoffStrategyOptions {
+  jitterType: ExponentialBackoffJitterType;
+  backoffScaleValue?: number;
+}

package/dist-types/ts3.4/token.d.ts

@@ -1,6 +1,4 @@
+import { TokenIdentity } from "./identity";
 import { Provider } from "./util";
-export interface Token {
-  readonly token: string;
-  readonly expiration?: Date;
-}
+export interface Token extends TokenIdentity {}
 export declare type TokenProvider = Provider<Token>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-sdk/types",
-  "version": "3.212.0",
+  "version": "3.222.0",
   "main": "./dist-cjs/index.js",
   "module": "./dist-es/index.js",
   "types": "./dist-types/index.d.ts",