Error Extractor (#91)

* add supports for service exception interface and error parser

* generate new clients

Author: AllanZhengYP

packages/types/src/exception.ts

@@ -0,0 +1,20 @@
+import {ResponseMetadata} from './response';
+import { MetadataBearer } from './index';
+
+/**
+ * Exceptions that responded from AWS service containing raw http response
+ * and parsed exception object
+ * 
+ * @property {any} details - parsed exception object normalized according to
+ * its API model
+ */
+export interface ServiceException<Details = any> extends Error, MetadataBearer {
+    details: Details;
+}
+
+/**
+ * Service exceptions that can not be parsed by unmarshallers' error parser
+ */
+export interface UnkownServiceException extends ServiceException<undefined> {
+    name: 'Error'
+}

packages/types/src/http.ts

@@ -67,6 +67,14 @@ export interface HttpResponse<StreamType = Uint8Array> extends
     statusCode: number;
 }
 
+/**
+ * Represents HTTP message whose body has been resolved to a string. This is 
+ * used in parsing http message.
+ */
+export interface ResolvedHttpResponse extends HttpResponse {
+    body: string
+}
+
 
 /**
  * A class that stores httpOptions and can make requests by calling handle.

packages/types/src/index.ts

@@ -3,6 +3,7 @@ export * from './client';
 export * from './command';
 export * from './credentials';
 export * from './crypto';
+export * from './exception';
 export * from './http';
 export * from './logger';
 export * from './marshaller';

packages/types/src/unmarshaller.ts

@@ -1,6 +1,13 @@
-import {Member, OperationModel} from "./protocol";
-import {HttpResponse} from "./http";
+import {
+    Member,
+    OperationModel,
+} from "./protocol";
+import {
+    HttpResponse, 
+    ResolvedHttpResponse,
+} from "./http";
 import {MetadataBearer} from './response';
+import {ServiceException} from './exception';
 
 export interface BodyParser<SerializedType = string> {
     /**
@@ -37,3 +44,11 @@ export interface ResponseParser<StreamType = Uint8Array> {
 export interface StreamCollector<StreamType> {
     (stream: StreamType): Promise<Uint8Array>;
 }
+
+/**
+ * A function that parses the http response when http status code > 299,
+ * parse the error response according to response and throw the ServiceException
+ */
+export interface ServiceExceptionParser {
+    (operation: OperationModel, response: ResolvedHttpResponse, errorBodyParser: BodyParser): ServiceException
+}