@aws-sdk/client-sfn 3.454.0 → 3.458.0

package/dist-types/models/models_0.d.ts

@@ -1009,7 +1009,7 @@ export interface DescribeExecutionOutput {
     stateMachineAliasArn?: string;
     /**
      * @public
-     * <p>The number of times you've redriven an execution. If you have not yet redriven an execution, the <code>redriveCount</code> is 0. This count is not updated for redrives that failed to start or are pending to be redriven.</p>
+     * <p>The number of times you've redriven an execution. If you have not yet redriven an execution, the <code>redriveCount</code> is 0. This count is only updated if you successfully redrive an execution.</p>
      */
     redriveCount?: number;
     /**
@@ -1148,7 +1148,7 @@ export interface MapRunExecutionCounts {
     resultsWritten: number | undefined;
     /**
      * @public
-     * <p>The number of <code>FAILED</code>, <code>ABORTED</code>, or <code>TIMED_OUT</code> child workflow executions that cannot be redriven because their execution status is terminal. For example, if your execution event history contains 25,000 entries, or the <code>toleratedFailureCount</code> or <code>toleratedFailurePercentage</code> for the Distributed Map has exceeded.</p>
+     * <p>The number of <code>FAILED</code>, <code>ABORTED</code>, or <code>TIMED_OUT</code> child workflow executions that cannot be redriven because their execution status is terminal. For example, child workflows with an execution status of <code>FAILED</code>, <code>ABORTED</code>, or <code>TIMED_OUT</code> and a <code>redriveStatus</code> of <code>NOT_REDRIVABLE</code>.</p>
      */
     failuresNotRedrivable?: number;
     /**
@@ -1204,7 +1204,7 @@ export interface MapRunItemCounts {
     resultsWritten: number | undefined;
     /**
      * @public
-     * <p>The number of <code>FAILED</code>, <code>ABORTED</code>, or <code>TIMED_OUT</code> items in child workflow executions that cannot be redriven because the execution status of those child workflows is terminal. For example, if your execution event history contains 25,000 entries, or the <code>toleratedFailureCount</code> or <code>toleratedFailurePercentage</code> for the Distributed Map has exceeded.</p>
+     * <p>The number of <code>FAILED</code>, <code>ABORTED</code>, or <code>TIMED_OUT</code> items in child workflow executions that cannot be redriven because the execution status of those child workflows is terminal. For example, child workflows with an execution status of <code>FAILED</code>, <code>ABORTED</code>, or <code>TIMED_OUT</code> and a <code>redriveStatus</code> of <code>NOT_REDRIVABLE</code>.</p>
      */
     failuresNotRedrivable?: number;
     /**
@@ -1283,7 +1283,7 @@ export interface DescribeMapRunOutput {
     executionCounts: MapRunExecutionCounts | undefined;
     /**
      * @public
-     * <p>The number of times you've redriven a Map Run. If you have not yet redriven a Map Run, the <code>redriveCount</code> is 0. This count is not updated for redrives that failed to start or are pending to be redriven.</p>
+     * <p>The number of times you've redriven a Map Run. If you have not yet redriven a Map Run, the <code>redriveCount</code> is 0. This count is only updated if you successfully redrive a Map Run.</p>
      */
     redriveCount?: number;
     /**
@@ -2665,7 +2665,7 @@ export interface ExecutionListItem {
     stateMachineAliasArn?: string;
     /**
      * @public
-     * <p>The number of times you've redriven an execution. If you have not yet redriven an execution, the <code>redriveCount</code> is 0. This count is not updated for redrives that failed to start or are pending to be redriven.</p>
+     * <p>The number of times you've redriven an execution. If you have not yet redriven an execution, the <code>redriveCount</code> is 0. This count is only updated when you successfully redrive an execution.</p>
      */
     redriveCount?: number;
     /**
@@ -3049,7 +3049,7 @@ export interface RedriveExecutionInput {
     executionArn: string | undefined;
     /**
      * @public
-     * <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don’t specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The API uses one of the last 10 client tokens provided.</p>
+     * <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you don’t specify a client token, the Amazon Web Services SDK automatically generates a client token and uses it for the request to ensure idempotency. The API will return idempotent responses for the last 10 client tokens used to successfully redrive the execution. These client tokens are valid for up to 15 minutes after they are first used.</p>
      */
     clientToken?: string;
 }
@@ -3494,6 +3494,223 @@ export interface TagResourceInput {
  */
 export interface TagResourceOutput {
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const InspectionLevel: {
+    readonly DEBUG: "DEBUG";
+    readonly INFO: "INFO";
+    readonly TRACE: "TRACE";
+};
+/**
+ * @public
+ */
+export type InspectionLevel = (typeof InspectionLevel)[keyof typeof InspectionLevel];
+/**
+ * @public
+ */
+export interface TestStateInput {
+    /**
+     * @public
+     * <p>The <a href="https://docs.aws.amazon.com/step-functions/latest/dg/concepts-amazon-states-language.html">Amazon States Language</a> (ASL) definition of the state.</p>
+     */
+    definition: string | undefined;
+    /**
+     * @public
+     * <p>The Amazon Resource Name (ARN) of the execution role with the required IAM permissions for the state.</p>
+     */
+    roleArn: string | undefined;
+    /**
+     * @public
+     * <p>A string that contains the JSON input data for the state.</p>
+     */
+    input?: string;
+    /**
+     * @public
+     * <p>Determines the values to return when a state is tested. You can specify one of the following types:</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>INFO</code>: Shows the final state output. By default, Step Functions sets <code>inspectionLevel</code> to <code>INFO</code> if you don't specify a level.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>DEBUG</code>: Shows the final state output along with the input and output data processing result.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>TRACE</code>: Shows the HTTP request and response for an HTTP Task. This level also shows the final state output along with the input and output data processing result.</p>
+     *             </li>
+     *          </ul>
+     *          <p>Each of these levels also provide information about the status of the state execution and the next state to transition to.</p>
+     */
+    inspectionLevel?: InspectionLevel;
+    /**
+     * @public
+     * <p>Specifies whether or not to include secret information in the test result. For HTTP Tasks, a secret includes the data that an EventBridge connection adds to modify the HTTP request headers, query parameters, and body. Step Functions doesn't omit any information included in the state definition or the HTTP response.</p>
+     *          <p>If you set <code>revealSecrets</code> to <code>true</code>, you must make sure that the IAM user that calls the <code>TestState</code> API has permission for the <code>states:RevealSecrets</code> action. For an example of IAM policy that sets the <code>states:RevealSecrets</code> permission, see <a href="https://docs.aws.amazon.com/step-functions/latest/dg/test-state-isolation.html#test-state-permissions">IAM permissions to test a state</a>. Without this permission, Step Functions throws an access denied error.</p>
+     *          <p>By default, <code>revealSecrets</code> is set to <code>false</code>.</p>
+     */
+    revealSecrets?: boolean;
+}
+/**
+ * @public
+ * <p>Contains additional details about the state's execution, including its input and output data processing flow, and HTTP request information.</p>
+ */
+export interface InspectionDataRequest {
+    /**
+     * @public
+     * <p>The protocol used to make the HTTP request.</p>
+     */
+    protocol?: string;
+    /**
+     * @public
+     * <p>The HTTP method used for the HTTP request.</p>
+     */
+    method?: string;
+    /**
+     * @public
+     * <p>The API endpoint used for the HTTP request.</p>
+     */
+    url?: string;
+    /**
+     * @public
+     * <p>The request headers associated with the HTTP request.</p>
+     */
+    headers?: string;
+    /**
+     * @public
+     * <p>The request body for the HTTP request.</p>
+     */
+    body?: string;
+}
+/**
+ * @public
+ * <p>Contains additional details about the state's execution, including its input and output data processing flow, and HTTP response information. The <code>inspectionLevel</code> request parameter specifies which details are returned.</p>
+ */
+export interface InspectionDataResponse {
+    /**
+     * @public
+     * <p>The protocol used to return the HTTP response.</p>
+     */
+    protocol?: string;
+    /**
+     * @public
+     * <p>The HTTP response status code for the HTTP response.</p>
+     */
+    statusCode?: string;
+    /**
+     * @public
+     * <p>The message associated with the HTTP status code.</p>
+     */
+    statusMessage?: string;
+    /**
+     * @public
+     * <p>The response headers associated with the HTTP response.</p>
+     */
+    headers?: string;
+    /**
+     * @public
+     * <p>The HTTP response returned.</p>
+     */
+    body?: string;
+}
+/**
+ * @public
+ * <p>Contains additional details about the state's execution, including its input and output data processing flow, and HTTP request and response information.</p>
+ */
+export interface InspectionData {
+    /**
+     * @public
+     * <p>The raw state input.</p>
+     */
+    input?: string;
+    /**
+     * @public
+     * <p>The input after Step Functions applies the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-inputpath">InputPath</a> filter.</p>
+     */
+    afterInputPath?: string;
+    /**
+     * @public
+     * <p>The effective input after Step Functions applies the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-parameters">Parameters</a> filter.</p>
+     */
+    afterParameters?: string;
+    /**
+     * @public
+     * <p>The state's raw result.</p>
+     */
+    result?: string;
+    /**
+     * @public
+     * <p>The effective result after Step Functions applies the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/input-output-inputpath-params.html#input-output-resultselector">ResultSelector</a> filter.</p>
+     */
+    afterResultSelector?: string;
+    /**
+     * @public
+     * <p>The effective result combined with the raw state input after Step Functions applies the <a href="https://docs.aws.amazon.com/step-functions/latest/dg/input-output-resultpath.html">ResultPath</a> filter.</p>
+     */
+    afterResultPath?: string;
+    /**
+     * @public
+     * <p>The raw HTTP request that is sent when you test an HTTP Task.</p>
+     */
+    request?: InspectionDataRequest;
+    /**
+     * @public
+     * <p>The raw HTTP response that is returned when you test an HTTP Task.</p>
+     */
+    response?: InspectionDataResponse;
+}
+/**
+ * @public
+ * @enum
+ */
+export declare const TestExecutionStatus: {
+    readonly CAUGHT_ERROR: "CAUGHT_ERROR";
+    readonly FAILED: "FAILED";
+    readonly RETRIABLE: "RETRIABLE";
+    readonly SUCCEEDED: "SUCCEEDED";
+};
+/**
+ * @public
+ */
+export type TestExecutionStatus = (typeof TestExecutionStatus)[keyof typeof TestExecutionStatus];
+/**
+ * @public
+ */
+export interface TestStateOutput {
+    /**
+     * @public
+     * <p>The JSON output data of the state. Length constraints apply to the payload size, and are expressed as bytes in UTF-8 encoding.</p>
+     */
+    output?: string;
+    /**
+     * @public
+     * <p>The error returned when the execution of a state fails.</p>
+     */
+    error?: string;
+    /**
+     * @public
+     * <p>A detailed explanation of the cause for the error when the execution of a state fails.</p>
+     */
+    cause?: string;
+    /**
+     * @public
+     * <p>Returns additional details about the state's execution, including its input and output data processing flow, and HTTP request and response information. The <code>inspectionLevel</code> request parameter specifies which details are returned.</p>
+     */
+    inspectionData?: InspectionData;
+    /**
+     * @public
+     * <p>The name of the next state to transition to. If you haven't defined a next state in your definition or if the execution of the state fails, this field doesn't contain a value.</p>
+     */
+    nextState?: string;
+    /**
+     * @public
+     * <p>The execution status of the state.</p>
+     */
+    status?: TestExecutionStatus;
+}
 /**
  * @public
  */
@@ -3821,6 +4038,18 @@ export declare const StartSyncExecutionOutputFilterSensitiveLog: (obj: StartSync
  * @internal
  */
 export declare const StopExecutionInputFilterSensitiveLog: (obj: StopExecutionInput) => any;
+/**
+ * @internal
+ */
+export declare const TestStateInputFilterSensitiveLog: (obj: TestStateInput) => any;
+/**
+ * @internal
+ */
+export declare const InspectionDataFilterSensitiveLog: (obj: InspectionData) => any;
+/**
+ * @internal
+ */
+export declare const TestStateOutputFilterSensitiveLog: (obj: TestStateOutput) => any;
 /**
  * @internal
  */

package/dist-types/protocols/Aws_json1_0.d.ts

@@ -31,6 +31,7 @@ import { StartExecutionCommandInput, StartExecutionCommandOutput } from "../comm
 import { StartSyncExecutionCommandInput, StartSyncExecutionCommandOutput } from "../commands/StartSyncExecutionCommand";
 import { StopExecutionCommandInput, StopExecutionCommandOutput } from "../commands/StopExecutionCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "../commands/TagResourceCommand";
+import { TestStateCommandInput, TestStateCommandOutput } from "../commands/TestStateCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "../commands/UntagResourceCommand";
 import { UpdateMapRunCommandInput, UpdateMapRunCommandOutput } from "../commands/UpdateMapRunCommand";
 import { UpdateStateMachineAliasCommandInput, UpdateStateMachineAliasCommandOutput } from "../commands/UpdateStateMachineAliasCommand";
@@ -159,6 +160,10 @@ export declare const se_StopExecutionCommand: (input: StopExecutionCommandInput,
  * serializeAws_json1_0TagResourceCommand
  */
 export declare const se_TagResourceCommand: (input: TagResourceCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
+/**
+ * serializeAws_json1_0TestStateCommand
+ */
+export declare const se_TestStateCommand: (input: TestStateCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 /**
  * serializeAws_json1_0UntagResourceCommand
  */
@@ -299,6 +304,10 @@ export declare const de_StopExecutionCommand: (output: __HttpResponse, context:
  * deserializeAws_json1_0TagResourceCommand
  */
 export declare const de_TagResourceCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<TagResourceCommandOutput>;
+/**
+ * deserializeAws_json1_0TestStateCommand
+ */
+export declare const de_TestStateCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<TestStateCommandOutput>;
 /**
  * deserializeAws_json1_0UntagResourceCommand
  */

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

@@ -123,6 +123,10 @@ import {
   TagResourceCommandInput,
   TagResourceCommandOutput,
 } from "./commands/TagResourceCommand";
+import {
+  TestStateCommandInput,
+  TestStateCommandOutput,
+} from "./commands/TestStateCommand";
 import {
   UntagResourceCommandInput,
   UntagResourceCommandOutput,
@@ -544,6 +548,19 @@ export interface SFN {
     options: __HttpHandlerOptions,
     cb: (err: any, data?: TagResourceCommandOutput) => void
   ): void;
+  testState(
+    args: TestStateCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<TestStateCommandOutput>;
+  testState(
+    args: TestStateCommandInput,
+    cb: (err: any, data?: TestStateCommandOutput) => void
+  ): void;
+  testState(
+    args: TestStateCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: TestStateCommandOutput) => void
+  ): void;
   untagResource(
     args: UntagResourceCommandInput,
     options?: __HttpHandlerOptions

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

@@ -169,6 +169,10 @@ import {
   TagResourceCommandInput,
   TagResourceCommandOutput,
 } from "./commands/TagResourceCommand";
+import {
+  TestStateCommandInput,
+  TestStateCommandOutput,
+} from "./commands/TestStateCommand";
 import {
   UntagResourceCommandInput,
   UntagResourceCommandOutput,
@@ -224,6 +228,7 @@ export type ServiceInputTypes =
   | StartSyncExecutionCommandInput
   | StopExecutionCommandInput
   | TagResourceCommandInput
+  | TestStateCommandInput
   | UntagResourceCommandInput
   | UpdateMapRunCommandInput
   | UpdateStateMachineAliasCommandInput
@@ -260,6 +265,7 @@ export type ServiceOutputTypes =
   | StartSyncExecutionCommandOutput
   | StopExecutionCommandOutput
   | TagResourceCommandOutput
+  | TestStateCommandOutput
   | UntagResourceCommandOutput
   | UpdateMapRunCommandOutput
   | UpdateStateMachineAliasCommandOutput

package/dist-types/ts3.4/commands/TestStateCommand.d.ts

@@ -0,0 +1,35 @@
+import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
+import { Command as $Command } from "@smithy/smithy-client";
+import {
+  Handler,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+} from "@smithy/types";
+import { TestStateInput, TestStateOutput } from "../models/models_0";
+import {
+  ServiceInputTypes,
+  ServiceOutputTypes,
+  SFNClientResolvedConfig,
+} from "../SFNClient";
+export { __MetadataBearer, $Command };
+export interface TestStateCommandInput extends TestStateInput {}
+export interface TestStateCommandOutput
+  extends TestStateOutput,
+    __MetadataBearer {}
+export declare class TestStateCommand extends $Command<
+  TestStateCommandInput,
+  TestStateCommandOutput,
+  SFNClientResolvedConfig
+> {
+  readonly input: TestStateCommandInput;
+  static getEndpointParameterInstructions(): EndpointParameterInstructions;
+  constructor(input: TestStateCommandInput);
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: SFNClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<TestStateCommandInput, TestStateCommandOutput>;
+  private serialize;
+  private deserialize;
+}

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

@@ -29,6 +29,7 @@ export * from "./StartExecutionCommand";
 export * from "./StartSyncExecutionCommand";
 export * from "./StopExecutionCommand";
 export * from "./TagResourceCommand";
+export * from "./TestStateCommand";
 export * from "./UntagResourceCommand";
 export * from "./UpdateMapRunCommand";
 export * from "./UpdateStateMachineAliasCommand";

package/dist-types/ts3.4/models/models_0.d.ts

@@ -896,6 +896,60 @@ export interface TagResourceInput {
   tags: Tag[] | undefined;
 }
 export interface TagResourceOutput {}
+export declare const InspectionLevel: {
+  readonly DEBUG: "DEBUG";
+  readonly INFO: "INFO";
+  readonly TRACE: "TRACE";
+};
+export type InspectionLevel =
+  (typeof InspectionLevel)[keyof typeof InspectionLevel];
+export interface TestStateInput {
+  definition: string | undefined;
+  roleArn: string | undefined;
+  input?: string;
+  inspectionLevel?: InspectionLevel;
+  revealSecrets?: boolean;
+}
+export interface InspectionDataRequest {
+  protocol?: string;
+  method?: string;
+  url?: string;
+  headers?: string;
+  body?: string;
+}
+export interface InspectionDataResponse {
+  protocol?: string;
+  statusCode?: string;
+  statusMessage?: string;
+  headers?: string;
+  body?: string;
+}
+export interface InspectionData {
+  input?: string;
+  afterInputPath?: string;
+  afterParameters?: string;
+  result?: string;
+  afterResultSelector?: string;
+  afterResultPath?: string;
+  request?: InspectionDataRequest;
+  response?: InspectionDataResponse;
+}
+export declare const TestExecutionStatus: {
+  readonly CAUGHT_ERROR: "CAUGHT_ERROR";
+  readonly FAILED: "FAILED";
+  readonly RETRIABLE: "RETRIABLE";
+  readonly SUCCEEDED: "SUCCEEDED";
+};
+export type TestExecutionStatus =
+  (typeof TestExecutionStatus)[keyof typeof TestExecutionStatus];
+export interface TestStateOutput {
+  output?: string;
+  error?: string;
+  cause?: string;
+  inspectionData?: InspectionData;
+  nextState?: string;
+  status?: TestExecutionStatus;
+}
 export interface UntagResourceInput {
   resourceArn: string | undefined;
   tagKeys: string[] | undefined;
@@ -1061,6 +1115,15 @@ export declare const StartSyncExecutionOutputFilterSensitiveLog: (
 export declare const StopExecutionInputFilterSensitiveLog: (
   obj: StopExecutionInput
 ) => any;
+export declare const TestStateInputFilterSensitiveLog: (
+  obj: TestStateInput
+) => any;
+export declare const InspectionDataFilterSensitiveLog: (
+  obj: InspectionData
+) => any;
+export declare const TestStateOutputFilterSensitiveLog: (
+  obj: TestStateOutput
+) => any;
 export declare const UpdateStateMachineInputFilterSensitiveLog: (
   obj: UpdateStateMachineInput
 ) => any;

package/dist-types/ts3.4/protocols/Aws_json1_0.d.ts

@@ -127,6 +127,10 @@ import {
   TagResourceCommandInput,
   TagResourceCommandOutput,
 } from "../commands/TagResourceCommand";
+import {
+  TestStateCommandInput,
+  TestStateCommandOutput,
+} from "../commands/TestStateCommand";
 import {
   UntagResourceCommandInput,
   UntagResourceCommandOutput,
@@ -267,6 +271,10 @@ export declare const se_TagResourceCommand: (
   input: TagResourceCommandInput,
   context: __SerdeContext
 ) => Promise<__HttpRequest>;
+export declare const se_TestStateCommand: (
+  input: TestStateCommandInput,
+  context: __SerdeContext
+) => Promise<__HttpRequest>;
 export declare const se_UntagResourceCommand: (
   input: UntagResourceCommandInput,
   context: __SerdeContext
@@ -407,6 +415,10 @@ export declare const de_TagResourceCommand: (
   output: __HttpResponse,
   context: __SerdeContext
 ) => Promise<TagResourceCommandOutput>;
+export declare const de_TestStateCommand: (
+  output: __HttpResponse,
+  context: __SerdeContext
+) => Promise<TestStateCommandOutput>;
 export declare const de_UntagResourceCommand: (
   output: __HttpResponse,
   context: __SerdeContext

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-sfn",
   "description": "AWS SDK for JavaScript Sfn Client for Node.js, Browser and React Native",
-  "version": "3.454.0",
+  "version": "3.458.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,9 +21,9 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.454.0",
+    "@aws-sdk/client-sts": "3.458.0",
     "@aws-sdk/core": "3.451.0",
-    "@aws-sdk/credential-provider-node": "3.451.0",
+    "@aws-sdk/credential-provider-node": "3.458.0",
     "@aws-sdk/middleware-host-header": "3.451.0",
     "@aws-sdk/middleware-logger": "3.451.0",
     "@aws-sdk/middleware-recursion-detection": "3.451.0",