feat(client-appsync): This release introduces the APPSYNC_JS runtime, and adds support for JavaScript in AppSync functions and AppSync pipeline resolvers.

awstools · awstools · commit 45452e5f5440 · 2022-11-17T19:28:09.000Z
diff --git a/clients/client-appsync/README.md b/clients/client-appsync/README.md
@@ -9,8 +9,8 @@
 
 AWS SDK for JavaScript AppSync Client for Node.js, Browser and React Native.
 
-<p>AppSync provides API actions for creating and interacting with data
-sources using GraphQL from your application.</p>
+<p>AppSync provides API actions for creating and interacting with data sources using GraphQL
+from your application.</p>
 
 ## Installing
 
diff --git a/clients/client-appsync/src/AppSync.ts b/clients/client-appsync/src/AppSync.ts
@@ -84,6 +84,11 @@ import {
   DisassociateApiCommandInput,
   DisassociateApiCommandOutput,
 } from "./commands/DisassociateApiCommand";
+import {
+  EvaluateCodeCommand,
+  EvaluateCodeCommandInput,
+  EvaluateCodeCommandOutput,
+} from "./commands/EvaluateCodeCommand";
 import {
   EvaluateMappingTemplateCommand,
   EvaluateMappingTemplateCommandInput,
@@ -214,8 +219,8 @@ import {
 import { UpdateTypeCommand, UpdateTypeCommandInput, UpdateTypeCommandOutput } from "./commands/UpdateTypeCommand";
 
 /**
- * <p>AppSync provides API actions for creating and interacting with data
- *          sources using GraphQL from your application.</p>
+ * <p>AppSync provides API actions for creating and interacting with data sources using GraphQL
+ *          from your application.</p>
  */
 export class AppSync extends AppSyncClient {
   /**
@@ -374,8 +379,7 @@ export class AppSync extends AppSyncClient {
 
   /**
    * <p>Creates a <code>Function</code> object.</p>
-   *          <p>A function is a reusable entity. You can use multiple functions to compose the resolver
-   *          logic.</p>
+   *          <p>A function is a reusable entity. You can use multiple functions to compose the resolver logic.</p>
    */
   public createFunction(
     args: CreateFunctionCommandInput,
@@ -440,8 +444,8 @@ export class AppSync extends AppSyncClient {
 
   /**
    * <p>Creates a <code>Resolver</code> object.</p>
-   *          <p>A resolver converts incoming requests into a format that a data source can understand,
-   *          and converts the data source's responses into GraphQL.</p>
+   *          <p>A resolver converts incoming requests into a format that a data source can understand, and converts the data
+   *          source's responses into GraphQL.</p>
    */
   public createResolver(
     args: CreateResolverCommandInput,
@@ -778,12 +782,44 @@ export class AppSync extends AppSyncClient {
   }
 
   /**
-   * <p>Evaluates a given template and returns the response. The mapping template can be a
-   *          request or response template.</p>
-   *          <p>Request templates take the incoming request after a GraphQL operation is parsed and
-   *          convert it into a request configuration for the selected data source operation. Response
-   *          templates interpret responses from the data source and map it to the shape of the GraphQL
-   *          field output type.</p>
+   * <p>Evaluates the given code and returns the response. The code definition requirements depend on the specified
+   *          runtime. For <code>APPSYNC_JS</code> runtimes, the code defines the request and response functions. The request
+   *          function takes the incoming request after a GraphQL operation is parsed and converts it into a request
+   *          configuration for the selected data source operation. The response function interprets responses from the data
+   *          source and maps it to the shape of the GraphQL field output type. </p>
+   */
+  public evaluateCode(
+    args: EvaluateCodeCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<EvaluateCodeCommandOutput>;
+  public evaluateCode(args: EvaluateCodeCommandInput, cb: (err: any, data?: EvaluateCodeCommandOutput) => void): void;
+  public evaluateCode(
+    args: EvaluateCodeCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: EvaluateCodeCommandOutput) => void
+  ): void;
+  public evaluateCode(
+    args: EvaluateCodeCommandInput,
+    optionsOrCb?: __HttpHandlerOptions | ((err: any, data?: EvaluateCodeCommandOutput) => void),
+    cb?: (err: any, data?: EvaluateCodeCommandOutput) => void
+  ): Promise<EvaluateCodeCommandOutput> | void {
+    const command = new EvaluateCodeCommand(args);
+    if (typeof optionsOrCb === "function") {
+      this.send(command, optionsOrCb);
+    } else if (typeof cb === "function") {
+      if (typeof optionsOrCb !== "object") throw new Error(`Expect http options but get ${typeof optionsOrCb}`);
+      this.send(command, optionsOrCb || {}, cb);
+    } else {
+      return this.send(command, optionsOrCb);
+    }
+  }
+
+  /**
+   * <p>Evaluates a given template and returns the response. The mapping template can be a request or response
+   *          template.</p>
+   *          <p>Request templates take the incoming request after a GraphQL operation is parsed and convert it into a
+   *          request configuration for the selected data source operation. Response templates interpret responses from the
+   *          data source and map it to the shape of the GraphQL field output type.</p>
    *          <p>Mapping templates are written in the Apache Velocity Template Language (VTL).</p>
    */
   public evaluateMappingTemplate(
@@ -1146,10 +1182,9 @@ export class AppSync extends AppSyncClient {
   /**
    * <p>Lists the API keys for a given API.</p>
    *          <note>
-   *             <p>API keys are deleted automatically 60 days after they expire. However, they may still
-   *             be included in the response until they have actually been deleted. You can safely call
-   *                <code>DeleteApiKey</code> to manually delete a key before it's automatically
-   *             deleted.</p>
+   *             <p>API keys are deleted automatically 60 days after they expire. However, they may still be included in the
+   *             response until they have actually been deleted. You can safely call <code>DeleteApiKey</code> to manually
+   *             delete a key before it's automatically deleted.</p>
    *          </note>
    */
   public listApiKeys(args: ListApiKeysCommandInput, options?: __HttpHandlerOptions): Promise<ListApiKeysCommandOutput>;
@@ -1427,8 +1462,8 @@ export class AppSync extends AppSyncClient {
 
   /**
    * <p>Adds a new schema to your GraphQL API.</p>
-   *          <p>This operation is asynchronous. Use  to
-   *          determine when it has completed.</p>
+   *          <p>This operation is asynchronous. Use  to determine when it has
+   *          completed.</p>
    */
   public startSchemaCreation(
     args: StartSchemaCreationCommandInput,
diff --git a/clients/client-appsync/src/AppSyncClient.ts b/clients/client-appsync/src/AppSyncClient.ts
@@ -65,6 +65,7 @@ import { DeleteGraphqlApiCommandInput, DeleteGraphqlApiCommandOutput } from "./c
 import { DeleteResolverCommandInput, DeleteResolverCommandOutput } from "./commands/DeleteResolverCommand";
 import { DeleteTypeCommandInput, DeleteTypeCommandOutput } from "./commands/DeleteTypeCommand";
 import { DisassociateApiCommandInput, DisassociateApiCommandOutput } from "./commands/DisassociateApiCommand";
+import { EvaluateCodeCommandInput, EvaluateCodeCommandOutput } from "./commands/EvaluateCodeCommand";
 import {
   EvaluateMappingTemplateCommandInput,
   EvaluateMappingTemplateCommandOutput,
@@ -142,6 +143,7 @@ export type ServiceInputTypes =
   | DeleteResolverCommandInput
   | DeleteTypeCommandInput
   | DisassociateApiCommandInput
+  | EvaluateCodeCommandInput
   | EvaluateMappingTemplateCommandInput
   | FlushApiCacheCommandInput
   | GetApiAssociationCommandInput
@@ -194,6 +196,7 @@ export type ServiceOutputTypes =
   | DeleteResolverCommandOutput
   | DeleteTypeCommandOutput
   | DisassociateApiCommandOutput
+  | EvaluateCodeCommandOutput
   | EvaluateMappingTemplateCommandOutput
   | FlushApiCacheCommandOutput
   | GetApiAssociationCommandOutput
@@ -377,8 +380,8 @@ type AppSyncClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandl
 export interface AppSyncClientResolvedConfig extends AppSyncClientResolvedConfigType {}
 
 /**
- * <p>AppSync provides API actions for creating and interacting with data
- *          sources using GraphQL from your application.</p>
+ * <p>AppSync provides API actions for creating and interacting with data sources using GraphQL
+ *          from your application.</p>
  */
 export class AppSyncClient extends __Client<
   __HttpHandlerOptions,
diff --git a/clients/client-appsync/src/commands/CreateFunctionCommand.ts b/clients/client-appsync/src/commands/CreateFunctionCommand.ts
@@ -30,8 +30,7 @@ export interface CreateFunctionCommandOutput extends CreateFunctionResponse, __M
 
 /**
  * <p>Creates a <code>Function</code> object.</p>
- *          <p>A function is a reusable entity. You can use multiple functions to compose the resolver
- *          logic.</p>
+ *          <p>A function is a reusable entity. You can use multiple functions to compose the resolver logic.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-appsync/src/commands/CreateResolverCommand.ts b/clients/client-appsync/src/commands/CreateResolverCommand.ts
@@ -30,8 +30,8 @@ export interface CreateResolverCommandOutput extends CreateResolverResponse, __M
 
 /**
  * <p>Creates a <code>Resolver</code> object.</p>
- *          <p>A resolver converts incoming requests into a format that a data source can understand,
- *          and converts the data source's responses into GraphQL.</p>
+ *          <p>A resolver converts incoming requests into a format that a data source can understand, and converts the data
+ *          source's responses into GraphQL.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-appsync/src/commands/EvaluateCodeCommand.ts b/clients/client-appsync/src/commands/EvaluateCodeCommand.ts
@@ -0,0 +1,116 @@
+// smithy-typescript generated code
+import { EndpointParameterInstructions, getEndpointPlugin } from "@aws-sdk/middleware-endpoint";
+import { getSerdePlugin } from "@aws-sdk/middleware-serde";
+import { HttpRequest as __HttpRequest, HttpResponse as __HttpResponse } from "@aws-sdk/protocol-http";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import {
+  FinalizeHandlerArguments,
+  Handler,
+  HandlerExecutionContext,
+  HttpHandlerOptions as __HttpHandlerOptions,
+  MetadataBearer as __MetadataBearer,
+  MiddlewareStack,
+  SerdeContext as __SerdeContext,
+} from "@aws-sdk/types";
+
+import { AppSyncClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../AppSyncClient";
+import {
+  EvaluateCodeRequest,
+  EvaluateCodeRequestFilterSensitiveLog,
+  EvaluateCodeResponse,
+  EvaluateCodeResponseFilterSensitiveLog,
+} from "../models/models_0";
+import {
+  deserializeAws_restJson1EvaluateCodeCommand,
+  serializeAws_restJson1EvaluateCodeCommand,
+} from "../protocols/Aws_restJson1";
+
+export interface EvaluateCodeCommandInput extends EvaluateCodeRequest {}
+export interface EvaluateCodeCommandOutput extends EvaluateCodeResponse, __MetadataBearer {}
+
+/**
+ * <p>Evaluates the given code and returns the response. The code definition requirements depend on the specified
+ *          runtime. For <code>APPSYNC_JS</code> runtimes, the code defines the request and response functions. The request
+ *          function takes the incoming request after a GraphQL operation is parsed and converts it into a request
+ *          configuration for the selected data source operation. The response function interprets responses from the data
+ *          source and maps it to the shape of the GraphQL field output type. </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { AppSyncClient, EvaluateCodeCommand } from "@aws-sdk/client-appsync"; // ES Modules import
+ * // const { AppSyncClient, EvaluateCodeCommand } = require("@aws-sdk/client-appsync"); // CommonJS import
+ * const client = new AppSyncClient(config);
+ * const command = new EvaluateCodeCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link EvaluateCodeCommandInput} for command's `input` shape.
+ * @see {@link EvaluateCodeCommandOutput} for command's `response` shape.
+ * @see {@link AppSyncClientResolvedConfig | config} for AppSyncClient's `config` shape.
+ *
+ */
+export class EvaluateCodeCommand extends $Command<
+  EvaluateCodeCommandInput,
+  EvaluateCodeCommandOutput,
+  AppSyncClientResolvedConfig
+> {
+  // Start section: command_properties
+  // End section: command_properties
+
+  public static getEndpointParameterInstructions(): EndpointParameterInstructions {
+    return {
+      UseFIPS: { type: "builtInParams", name: "useFipsEndpoint" },
+      Endpoint: { type: "builtInParams", name: "endpoint" },
+      Region: { type: "builtInParams", name: "region" },
+      UseDualStack: { type: "builtInParams", name: "useDualstackEndpoint" },
+    };
+  }
+
+  constructor(readonly input: EvaluateCodeCommandInput) {
+    // Start section: command_constructor
+    super();
+    // End section: command_constructor
+  }
+
+  /**
+   * @internal
+   */
+  resolveMiddleware(
+    clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>,
+    configuration: AppSyncClientResolvedConfig,
+    options?: __HttpHandlerOptions
+  ): Handler<EvaluateCodeCommandInput, EvaluateCodeCommandOutput> {
+    this.middlewareStack.use(getSerdePlugin(configuration, this.serialize, this.deserialize));
+    this.middlewareStack.use(getEndpointPlugin(configuration, EvaluateCodeCommand.getEndpointParameterInstructions()));
+
+    const stack = clientStack.concat(this.middlewareStack);
+
+    const { logger } = configuration;
+    const clientName = "AppSyncClient";
+    const commandName = "EvaluateCodeCommand";
+    const handlerExecutionContext: HandlerExecutionContext = {
+      logger,
+      clientName,
+      commandName,
+      inputFilterSensitiveLog: EvaluateCodeRequestFilterSensitiveLog,
+      outputFilterSensitiveLog: EvaluateCodeResponseFilterSensitiveLog,
+    };
+    const { requestHandler } = configuration;
+    return stack.resolve(
+      (request: FinalizeHandlerArguments<any>) =>
+        requestHandler.handle(request.request as __HttpRequest, options || {}),
+      handlerExecutionContext
+    );
+  }
+
+  private serialize(input: EvaluateCodeCommandInput, context: __SerdeContext): Promise<__HttpRequest> {
+    return serializeAws_restJson1EvaluateCodeCommand(input, context);
+  }
+
+  private deserialize(output: __HttpResponse, context: __SerdeContext): Promise<EvaluateCodeCommandOutput> {
+    return deserializeAws_restJson1EvaluateCodeCommand(output, context);
+  }
+
+  // Start section: command_body_extra
+  // End section: command_body_extra
+}
diff --git a/clients/client-appsync/src/commands/EvaluateMappingTemplateCommand.ts b/clients/client-appsync/src/commands/EvaluateMappingTemplateCommand.ts
@@ -29,12 +29,11 @@ export interface EvaluateMappingTemplateCommandInput extends EvaluateMappingTemp
 export interface EvaluateMappingTemplateCommandOutput extends EvaluateMappingTemplateResponse, __MetadataBearer {}
 
 /**
- * <p>Evaluates a given template and returns the response. The mapping template can be a
- *          request or response template.</p>
- *          <p>Request templates take the incoming request after a GraphQL operation is parsed and
- *          convert it into a request configuration for the selected data source operation. Response
- *          templates interpret responses from the data source and map it to the shape of the GraphQL
- *          field output type.</p>
+ * <p>Evaluates a given template and returns the response. The mapping template can be a request or response
+ *          template.</p>
+ *          <p>Request templates take the incoming request after a GraphQL operation is parsed and convert it into a
+ *          request configuration for the selected data source operation. Response templates interpret responses from the
+ *          data source and map it to the shape of the GraphQL field output type.</p>
  *          <p>Mapping templates are written in the Apache Velocity Template Language (VTL).</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-appsync/src/commands/ListApiKeysCommand.ts b/clients/client-appsync/src/commands/ListApiKeysCommand.ts
@@ -31,10 +31,9 @@ export interface ListApiKeysCommandOutput extends ListApiKeysResponse, __Metadat
 /**
  * <p>Lists the API keys for a given API.</p>
  *          <note>
- *             <p>API keys are deleted automatically 60 days after they expire. However, they may still
- *             be included in the response until they have actually been deleted. You can safely call
- *                <code>DeleteApiKey</code> to manually delete a key before it's automatically
- *             deleted.</p>
+ *             <p>API keys are deleted automatically 60 days after they expire. However, they may still be included in the
+ *             response until they have actually been deleted. You can safely call <code>DeleteApiKey</code> to manually
+ *             delete a key before it's automatically deleted.</p>
  *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-appsync/src/commands/StartSchemaCreationCommand.ts b/clients/client-appsync/src/commands/StartSchemaCreationCommand.ts
@@ -30,8 +30,8 @@ export interface StartSchemaCreationCommandOutput extends StartSchemaCreationRes
 
 /**
  * <p>Adds a new schema to your GraphQL API.</p>
- *          <p>This operation is asynchronous. Use  to
- *          determine when it has completed.</p>
+ *          <p>This operation is asynchronous. Use  to determine when it has
+ *          completed.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-appsync/src/commands/index.ts b/clients/client-appsync/src/commands/index.ts
@@ -17,6 +17,7 @@ export * from "./DeleteGraphqlApiCommand";
 export * from "./DeleteResolverCommand";
 export * from "./DeleteTypeCommand";
 export * from "./DisassociateApiCommand";
+export * from "./EvaluateCodeCommand";
 export * from "./EvaluateMappingTemplateCommand";
 export * from "./FlushApiCacheCommand";
 export * from "./GetApiAssociationCommand";
diff --git a/clients/client-appsync/src/models/models_0.ts b/clients/client-appsync/src/models/models_0.ts
diff --git a/clients/client-appsync/src/protocols/Aws_restJson1.ts b/clients/client-appsync/src/protocols/Aws_restJson1.ts
diff --git a/codegen/sdk-codegen/aws-models/appsync.json b/codegen/sdk-codegen/aws-models/appsync.json
