@aws-sdk/client-personalize-runtime 3.141.0 → 3.149.0

package/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.149.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.148.0...v3.149.0) (2022-08-12)
+
+
+### Features
+
+* **client-personalize-runtime:** This release provides support for promotions in AWS Personalize runtime. ([f7e4104](https://github.com/aws/aws-sdk-js-v3/commit/f7e410466be43961aec27fa05f5e0aa3eae0df8b))
+
+
+
+
+
+# [3.145.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.144.0...v3.145.0) (2022-08-08)
+
+**Note:** Version bump only for package @aws-sdk/client-personalize-runtime
+
+
+
+
+
+# [3.142.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.141.0...v3.142.0) (2022-08-02)
+
+
+### Features
+
+* **codegen:** general data mapping function ([#3830](https://github.com/aws/aws-sdk-js-v3/issues/3830)) ([9417eae](https://github.com/aws/aws-sdk-js-v3/commit/9417eae722806799fb4c15c07921574268c1165c))
+
+
+
+
+
 # [3.141.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.140.0...v3.141.0) (2022-08-01)
 
 

package/dist-cjs/models/models_0.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetRecommendationsResponseFilterSensitiveLog = exports.GetRecommendationsRequestFilterSensitiveLog = exports.GetPersonalizedRankingResponseFilterSensitiveLog = exports.PredictedItemFilterSensitiveLog = exports.GetPersonalizedRankingRequestFilterSensitiveLog = exports.ResourceNotFoundException = exports.InvalidInputException = void 0;
+exports.GetRecommendationsResponseFilterSensitiveLog = exports.GetRecommendationsRequestFilterSensitiveLog = exports.PromotionFilterSensitiveLog = exports.GetPersonalizedRankingResponseFilterSensitiveLog = exports.PredictedItemFilterSensitiveLog = exports.GetPersonalizedRankingRequestFilterSensitiveLog = exports.ResourceNotFoundException = exports.InvalidInputException = void 0;
 const smithy_client_1 = require("@aws-sdk/smithy-client");
 const PersonalizeRuntimeServiceException_1 = require("./PersonalizeRuntimeServiceException");
 class InvalidInputException extends PersonalizeRuntimeServiceException_1.PersonalizeRuntimeServiceException {
@@ -43,10 +43,16 @@ const GetPersonalizedRankingResponseFilterSensitiveLog = (obj) => ({
     ...obj,
 });
 exports.GetPersonalizedRankingResponseFilterSensitiveLog = GetPersonalizedRankingResponseFilterSensitiveLog;
+const PromotionFilterSensitiveLog = (obj) => ({
+    ...obj,
+    ...(obj.filterValues && { filterValues: smithy_client_1.SENSITIVE_STRING }),
+});
+exports.PromotionFilterSensitiveLog = PromotionFilterSensitiveLog;
 const GetRecommendationsRequestFilterSensitiveLog = (obj) => ({
     ...obj,
     ...(obj.context && { context: smithy_client_1.SENSITIVE_STRING }),
     ...(obj.filterValues && { filterValues: smithy_client_1.SENSITIVE_STRING }),
+    ...(obj.promotions && { promotions: obj.promotions.map((item) => (0, exports.PromotionFilterSensitiveLog)(item)) }),
 });
 exports.GetRecommendationsRequestFilterSensitiveLog = GetRecommendationsRequestFilterSensitiveLog;
 const GetRecommendationsResponseFilterSensitiveLog = (obj) => ({

package/dist-cjs/protocols/Aws_restJson1.js

@@ -49,6 +49,7 @@ const serializeAws_restJson1GetRecommendationsCommand = async (input, context) =
         }),
         ...(input.itemId != null && { itemId: input.itemId }),
         ...(input.numResults != null && { numResults: input.numResults }),
+        ...(input.promotions != null && { promotions: serializeAws_restJson1PromotionList(input.promotions, context) }),
         ...(input.recommenderArn != null && { recommenderArn: input.recommenderArn }),
         ...(input.userId != null && { userId: input.userId }),
     });
@@ -67,19 +68,17 @@ const deserializeAws_restJson1GetPersonalizedRankingCommand = async (output, con
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return deserializeAws_restJson1GetPersonalizedRankingCommandError(output, context);
     }
-    const contents = {
+    const contents = map({
         $metadata: deserializeMetadata(output),
-        personalizedRanking: undefined,
-        recommendationId: undefined,
-    };
+    });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
-    if (data.personalizedRanking !== undefined && data.personalizedRanking !== null) {
+    if (data.personalizedRanking != null) {
         contents.personalizedRanking = deserializeAws_restJson1ItemList(data.personalizedRanking, context);
     }
-    if (data.recommendationId !== undefined && data.recommendationId !== null) {
+    if (data.recommendationId != null) {
         contents.recommendationId = (0, smithy_client_1.expectString)(data.recommendationId);
     }
-    return Promise.resolve(contents);
+    return contents;
 };
 exports.deserializeAws_restJson1GetPersonalizedRankingCommand = deserializeAws_restJson1GetPersonalizedRankingCommand;
 const deserializeAws_restJson1GetPersonalizedRankingCommandError = async (output, context) => {
@@ -87,7 +86,6 @@ const deserializeAws_restJson1GetPersonalizedRankingCommandError = async (output
         ...output,
         body: await parseBody(output.body, context),
     };
-    let response;
     const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
     switch (errorCode) {
         case "InvalidInputException":
@@ -98,33 +96,29 @@ const deserializeAws_restJson1GetPersonalizedRankingCommandError = async (output
             throw await deserializeAws_restJson1ResourceNotFoundExceptionResponse(parsedOutput, context);
         default:
             const parsedBody = parsedOutput.body;
-            const $metadata = deserializeMetadata(output);
-            const statusCode = $metadata.httpStatusCode ? $metadata.httpStatusCode + "" : undefined;
-            response = new PersonalizeRuntimeServiceException_1.PersonalizeRuntimeServiceException({
-                name: parsedBody.code || parsedBody.Code || errorCode || statusCode || "UnknowError",
-                $fault: "client",
-                $metadata,
+            (0, smithy_client_1.throwDefaultError)({
+                output,
+                parsedBody,
+                exceptionCtor: PersonalizeRuntimeServiceException_1.PersonalizeRuntimeServiceException,
+                errorCode,
             });
-            throw (0, smithy_client_1.decorateServiceException)(response, parsedBody);
     }
 };
 const deserializeAws_restJson1GetRecommendationsCommand = async (output, context) => {
     if (output.statusCode !== 200 && output.statusCode >= 300) {
         return deserializeAws_restJson1GetRecommendationsCommandError(output, context);
     }
-    const contents = {
+    const contents = map({
         $metadata: deserializeMetadata(output),
-        itemList: undefined,
-        recommendationId: undefined,
-    };
+    });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
-    if (data.itemList !== undefined && data.itemList !== null) {
+    if (data.itemList != null) {
         contents.itemList = deserializeAws_restJson1ItemList(data.itemList, context);
     }
-    if (data.recommendationId !== undefined && data.recommendationId !== null) {
+    if (data.recommendationId != null) {
         contents.recommendationId = (0, smithy_client_1.expectString)(data.recommendationId);
     }
-    return Promise.resolve(contents);
+    return contents;
 };
 exports.deserializeAws_restJson1GetRecommendationsCommand = deserializeAws_restJson1GetRecommendationsCommand;
 const deserializeAws_restJson1GetRecommendationsCommandError = async (output, context) => {
@@ -132,7 +126,6 @@ const deserializeAws_restJson1GetRecommendationsCommandError = async (output, co
         ...output,
         body: await parseBody(output.body, context),
     };
-    let response;
     const errorCode = loadRestJsonErrorCode(output, parsedOutput.body);
     switch (errorCode) {
         case "InvalidInputException":
@@ -143,20 +136,19 @@ const deserializeAws_restJson1GetRecommendationsCommandError = async (output, co
             throw await deserializeAws_restJson1ResourceNotFoundExceptionResponse(parsedOutput, context);
         default:
             const parsedBody = parsedOutput.body;
-            const $metadata = deserializeMetadata(output);
-            const statusCode = $metadata.httpStatusCode ? $metadata.httpStatusCode + "" : undefined;
-            response = new PersonalizeRuntimeServiceException_1.PersonalizeRuntimeServiceException({
-                name: parsedBody.code || parsedBody.Code || errorCode || statusCode || "UnknowError",
-                $fault: "client",
-                $metadata,
+            (0, smithy_client_1.throwDefaultError)({
+                output,
+                parsedBody,
+                exceptionCtor: PersonalizeRuntimeServiceException_1.PersonalizeRuntimeServiceException,
+                errorCode,
             });
-            throw (0, smithy_client_1.decorateServiceException)(response, parsedBody);
     }
 };
+const map = smithy_client_1.map;
 const deserializeAws_restJson1InvalidInputExceptionResponse = async (parsedOutput, context) => {
-    const contents = {};
+    const contents = map({});
     const data = parsedOutput.body;
-    if (data.message !== undefined && data.message !== null) {
+    if (data.message != null) {
         contents.message = (0, smithy_client_1.expectString)(data.message);
     }
     const exception = new models_0_1.InvalidInputException({
@@ -166,9 +158,9 @@ const deserializeAws_restJson1InvalidInputExceptionResponse = async (parsedOutpu
     return (0, smithy_client_1.decorateServiceException)(exception, parsedOutput.body);
 };
 const deserializeAws_restJson1ResourceNotFoundExceptionResponse = async (parsedOutput, context) => {
-    const contents = {};
+    const contents = map({});
     const data = parsedOutput.body;
-    if (data.message !== undefined && data.message !== null) {
+    if (data.message != null) {
         contents.message = (0, smithy_client_1.expectString)(data.message);
     }
     const exception = new models_0_1.ResourceNotFoundException({
@@ -203,12 +195,26 @@ const serializeAws_restJson1InputList = (input, context) => {
     return input
         .filter((e) => e != null)
         .map((entry) => {
-        if (entry === null) {
-            return null;
-        }
         return entry;
     });
 };
+const serializeAws_restJson1Promotion = (input, context) => {
+    return {
+        ...(input.filterArn != null && { filterArn: input.filterArn }),
+        ...(input.filterValues != null && {
+            filterValues: serializeAws_restJson1FilterValues(input.filterValues, context),
+        }),
+        ...(input.name != null && { name: input.name }),
+        ...(input.percentPromotedItems != null && { percentPromotedItems: input.percentPromotedItems }),
+    };
+};
+const serializeAws_restJson1PromotionList = (input, context) => {
+    return input
+        .filter((e) => e != null)
+        .map((entry) => {
+        return serializeAws_restJson1Promotion(entry, context);
+    });
+};
 const deserializeAws_restJson1ItemList = (output, context) => {
     const retVal = (output || [])
         .filter((e) => e != null)
@@ -223,6 +229,7 @@ const deserializeAws_restJson1ItemList = (output, context) => {
 const deserializeAws_restJson1PredictedItem = (output, context) => {
     return {
         itemId: (0, smithy_client_1.expectString)(output.itemId),
+        promotionName: (0, smithy_client_1.expectString)(output.promotionName),
         score: (0, smithy_client_1.limitedParseDouble)(output.score),
     };
 };

package/dist-es/models/models_0.js

@@ -28,5 +28,6 @@ export { ResourceNotFoundException };
 export var GetPersonalizedRankingRequestFilterSensitiveLog = function (obj) { return (__assign(__assign(__assign({}, obj), (obj.context && { context: SENSITIVE_STRING })), (obj.filterValues && { filterValues: SENSITIVE_STRING }))); };
 export var PredictedItemFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
 export var GetPersonalizedRankingResponseFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };
-export var GetRecommendationsRequestFilterSensitiveLog = function (obj) { return (__assign(__assign(__assign({}, obj), (obj.context && { context: SENSITIVE_STRING })), (obj.filterValues && { filterValues: SENSITIVE_STRING }))); };
+export var PromotionFilterSensitiveLog = function (obj) { return (__assign(__assign({}, obj), (obj.filterValues && { filterValues: SENSITIVE_STRING }))); };
+export var GetRecommendationsRequestFilterSensitiveLog = function (obj) { return (__assign(__assign(__assign(__assign({}, obj), (obj.context && { context: SENSITIVE_STRING })), (obj.filterValues && { filterValues: SENSITIVE_STRING })), (obj.promotions && { promotions: obj.promotions.map(function (item) { return PromotionFilterSensitiveLog(item); }) }))); };
 export var GetRecommendationsResponseFilterSensitiveLog = function (obj) { return (__assign({}, obj)); };

package/dist-es/protocols/Aws_restJson1.js

@@ -1,6 +1,6 @@
 import { __assign, __awaiter, __generator, __read } from "tslib";
 import { HttpRequest as __HttpRequest } from "@aws-sdk/protocol-http";
-import { decorateServiceException as __decorateServiceException, expectNonNull as __expectNonNull, expectObject as __expectObject, expectString as __expectString, limitedParseDouble as __limitedParseDouble, } from "@aws-sdk/smithy-client";
+import { decorateServiceException as __decorateServiceException, expectNonNull as __expectNonNull, expectObject as __expectObject, expectString as __expectString, limitedParseDouble as __limitedParseDouble, map as __map, throwDefaultError, } from "@aws-sdk/smithy-client";
 import { InvalidInputException, ResourceNotFoundException } from "../models/models_0";
 import { PersonalizeRuntimeServiceException as __BaseException } from "../models/PersonalizeRuntimeServiceException";
 export var serializeAws_restJson1GetPersonalizedRankingCommand = function (input, context) { return __awaiter(void 0, void 0, void 0, function () {
@@ -40,9 +40,9 @@ export var serializeAws_restJson1GetRecommendationsCommand = function (input, co
                     "content-type": "application/json",
                 };
                 resolvedPath = "".concat((basePath === null || basePath === void 0 ? void 0 : basePath.endsWith("/")) ? basePath.slice(0, -1) : basePath || "") + "/recommendations";
-                body = JSON.stringify(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (input.campaignArn != null && { campaignArn: input.campaignArn })), (input.context != null && { context: serializeAws_restJson1Context(input.context, context) })), (input.filterArn != null && { filterArn: input.filterArn })), (input.filterValues != null && {
+                body = JSON.stringify(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign(__assign({}, (input.campaignArn != null && { campaignArn: input.campaignArn })), (input.context != null && { context: serializeAws_restJson1Context(input.context, context) })), (input.filterArn != null && { filterArn: input.filterArn })), (input.filterValues != null && {
                     filterValues: serializeAws_restJson1FilterValues(input.filterValues, context),
-                })), (input.itemId != null && { itemId: input.itemId })), (input.numResults != null && { numResults: input.numResults })), (input.recommenderArn != null && { recommenderArn: input.recommenderArn })), (input.userId != null && { userId: input.userId })));
+                })), (input.itemId != null && { itemId: input.itemId })), (input.numResults != null && { numResults: input.numResults })), (input.promotions != null && { promotions: serializeAws_restJson1PromotionList(input.promotions, context) })), (input.recommenderArn != null && { recommenderArn: input.recommenderArn })), (input.userId != null && { userId: input.userId })));
                 return [2, new __HttpRequest({
                         protocol: protocol,
                         hostname: hostname,
@@ -63,28 +63,26 @@ export var deserializeAws_restJson1GetPersonalizedRankingCommand = function (out
                 if (output.statusCode !== 200 && output.statusCode >= 300) {
                     return [2, deserializeAws_restJson1GetPersonalizedRankingCommandError(output, context)];
                 }
-                contents = {
+                contents = map({
                     $metadata: deserializeMetadata(output),
-                    personalizedRanking: undefined,
-                    recommendationId: undefined,
-                };
+                });
                 _a = __expectNonNull;
                 _b = __expectObject;
                 return [4, parseBody(output.body, context)];
             case 1:
                 data = _a.apply(void 0, [_b.apply(void 0, [_c.sent()]), "body"]);
-                if (data.personalizedRanking !== undefined && data.personalizedRanking !== null) {
+                if (data.personalizedRanking != null) {
                     contents.personalizedRanking = deserializeAws_restJson1ItemList(data.personalizedRanking, context);
                 }
-                if (data.recommendationId !== undefined && data.recommendationId !== null) {
+                if (data.recommendationId != null) {
                     contents.recommendationId = __expectString(data.recommendationId);
                 }
-                return [2, Promise.resolve(contents)];
+                return [2, contents];
         }
     });
 }); };
 var deserializeAws_restJson1GetPersonalizedRankingCommandError = function (output, context) { return __awaiter(void 0, void 0, void 0, function () {
-    var parsedOutput, _a, response, errorCode, _b, parsedBody, $metadata, statusCode;
+    var parsedOutput, _a, errorCode, _b, parsedBody;
     var _c;
     return __generator(this, function (_d) {
         switch (_d.label) {
@@ -109,14 +107,14 @@ var deserializeAws_restJson1GetPersonalizedRankingCommandError = function (outpu
             case 5: throw _d.sent();
             case 6:
                 parsedBody = parsedOutput.body;
-                $metadata = deserializeMetadata(output);
-                statusCode = $metadata.httpStatusCode ? $metadata.httpStatusCode + "" : undefined;
-                response = new __BaseException({
-                    name: parsedBody.code || parsedBody.Code || errorCode || statusCode || "UnknowError",
-                    $fault: "client",
-                    $metadata: $metadata,
+                throwDefaultError({
+                    output: output,
+                    parsedBody: parsedBody,
+                    exceptionCtor: __BaseException,
+                    errorCode: errorCode,
                 });
-                throw __decorateServiceException(response, parsedBody);
+                _d.label = 7;
+            case 7: return [2];
         }
     });
 }); };
@@ -128,28 +126,26 @@ export var deserializeAws_restJson1GetRecommendationsCommand = function (output,
                 if (output.statusCode !== 200 && output.statusCode >= 300) {
                     return [2, deserializeAws_restJson1GetRecommendationsCommandError(output, context)];
                 }
-                contents = {
+                contents = map({
                     $metadata: deserializeMetadata(output),
-                    itemList: undefined,
-                    recommendationId: undefined,
-                };
+                });
                 _a = __expectNonNull;
                 _b = __expectObject;
                 return [4, parseBody(output.body, context)];
             case 1:
                 data = _a.apply(void 0, [_b.apply(void 0, [_c.sent()]), "body"]);
-                if (data.itemList !== undefined && data.itemList !== null) {
+                if (data.itemList != null) {
                     contents.itemList = deserializeAws_restJson1ItemList(data.itemList, context);
                 }
-                if (data.recommendationId !== undefined && data.recommendationId !== null) {
+                if (data.recommendationId != null) {
                     contents.recommendationId = __expectString(data.recommendationId);
                 }
-                return [2, Promise.resolve(contents)];
+                return [2, contents];
         }
     });
 }); };
 var deserializeAws_restJson1GetRecommendationsCommandError = function (output, context) { return __awaiter(void 0, void 0, void 0, function () {
-    var parsedOutput, _a, response, errorCode, _b, parsedBody, $metadata, statusCode;
+    var parsedOutput, _a, errorCode, _b, parsedBody;
     var _c;
     return __generator(this, function (_d) {
         switch (_d.label) {
@@ -174,23 +170,24 @@ var deserializeAws_restJson1GetRecommendationsCommandError = function (output, c
             case 5: throw _d.sent();
             case 6:
                 parsedBody = parsedOutput.body;
-                $metadata = deserializeMetadata(output);
-                statusCode = $metadata.httpStatusCode ? $metadata.httpStatusCode + "" : undefined;
-                response = new __BaseException({
-                    name: parsedBody.code || parsedBody.Code || errorCode || statusCode || "UnknowError",
-                    $fault: "client",
-                    $metadata: $metadata,
+                throwDefaultError({
+                    output: output,
+                    parsedBody: parsedBody,
+                    exceptionCtor: __BaseException,
+                    errorCode: errorCode,
                 });
-                throw __decorateServiceException(response, parsedBody);
+                _d.label = 7;
+            case 7: return [2];
         }
     });
 }); };
+var map = __map;
 var deserializeAws_restJson1InvalidInputExceptionResponse = function (parsedOutput, context) { return __awaiter(void 0, void 0, void 0, function () {
     var contents, data, exception;
     return __generator(this, function (_a) {
-        contents = {};
+        contents = map({});
         data = parsedOutput.body;
-        if (data.message !== undefined && data.message !== null) {
+        if (data.message != null) {
             contents.message = __expectString(data.message);
         }
         exception = new InvalidInputException(__assign({ $metadata: deserializeMetadata(parsedOutput) }, contents));
@@ -200,9 +197,9 @@ var deserializeAws_restJson1InvalidInputExceptionResponse = function (parsedOutp
 var deserializeAws_restJson1ResourceNotFoundExceptionResponse = function (parsedOutput, context) { return __awaiter(void 0, void 0, void 0, function () {
     var contents, data, exception;
     return __generator(this, function (_a) {
-        contents = {};
+        contents = map({});
         data = parsedOutput.body;
-        if (data.message !== undefined && data.message !== null) {
+        if (data.message != null) {
             contents.message = __expectString(data.message);
         }
         exception = new ResourceNotFoundException(__assign({ $metadata: deserializeMetadata(parsedOutput) }, contents));
@@ -233,12 +230,21 @@ var serializeAws_restJson1InputList = function (input, context) {
     return input
         .filter(function (e) { return e != null; })
         .map(function (entry) {
-        if (entry === null) {
-            return null;
-        }
         return entry;
     });
 };
+var serializeAws_restJson1Promotion = function (input, context) {
+    return __assign(__assign(__assign(__assign({}, (input.filterArn != null && { filterArn: input.filterArn })), (input.filterValues != null && {
+        filterValues: serializeAws_restJson1FilterValues(input.filterValues, context),
+    })), (input.name != null && { name: input.name })), (input.percentPromotedItems != null && { percentPromotedItems: input.percentPromotedItems }));
+};
+var serializeAws_restJson1PromotionList = function (input, context) {
+    return input
+        .filter(function (e) { return e != null; })
+        .map(function (entry) {
+        return serializeAws_restJson1Promotion(entry, context);
+    });
+};
 var deserializeAws_restJson1ItemList = function (output, context) {
     var retVal = (output || [])
         .filter(function (e) { return e != null; })
@@ -253,6 +259,7 @@ var deserializeAws_restJson1ItemList = function (output, context) {
 var deserializeAws_restJson1PredictedItem = function (output, context) {
     return {
         itemId: __expectString(output.itemId),
+        promotionName: __expectString(output.promotionName),
         score: __limitedParseDouble(output.score),
     };
 };

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

@@ -56,6 +56,10 @@ export interface PredictedItem {
      *       selection. For more information on scoring logic, see <a>how-scores-work</a>.</p>
      */
     score?: number;
+    /**
+     * <p>The name of the promotion that included the predicted item.</p>
+     */
+    promotionName?: string;
 }
 export interface GetPersonalizedRankingResponse {
     /**
@@ -89,6 +93,37 @@ export declare class ResourceNotFoundException extends __BaseException {
      */
     constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
 }
+/**
+ * <p>Contains information on a promotion. A promotion defines additional business rules that apply to a configurable subset of recommended items.</p>
+ */
+export interface Promotion {
+    /**
+     * <p>The name of the promotion.</p>
+     */
+    name?: string;
+    /**
+     * <p>The percentage of recommended items to apply the promotion to.</p>
+     */
+    percentPromotedItems?: number;
+    /**
+     * <p>The Amazon Resource Name (ARN) of the filter used by the promotion. This filter defines the criteria for promoted items. For more information, see
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters">Promotion filters</a>.</p>
+     */
+    filterArn?: string;
+    /**
+     * <p>The values to use when promoting items.
+     *       For each placeholder parameter in your promotion's filter expression, provide the parameter name (in matching case) as a key and the filter value(s) as the corresponding value. Separate multiple values for one parameter with a comma.
+     *     </p>
+     *          <p>For filter expressions that use an <code>INCLUDE</code> element to include items,
+     *       you must provide values for all parameters that are defined in the expression. For
+     *       filters with expressions that use an <code>EXCLUDE</code> element to exclude items, you
+     *       can omit the <code>filter-values</code>. In this case, Amazon Personalize doesn't use that portion of
+     *       the expression to filter recommendations.</p>
+     *          <p>For more information on creating filters, see
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/filter.html">Filtering recommendations and user segments</a>.</p>
+     */
+    filterValues?: Record<string, string>;
+}
 export interface GetRecommendationsRequest {
     /**
      * <p>The Amazon Resource Name (ARN) of the campaign to use for getting recommendations.</p>
@@ -130,7 +165,7 @@ export interface GetRecommendationsRequest {
      *       can omit the <code>filter-values</code>.In this case, Amazon Personalize doesn't use that portion of
      *     the expression to filter recommendations.</p>
      *          <p>For more information, see
-     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/filter.html">Filtering Recommendations</a>.</p>
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/filter.html">Filtering recommendations and user segments</a>.</p>
      */
     filterValues?: Record<string, string>;
     /**
@@ -138,6 +173,11 @@ export interface GetRecommendationsRequest {
      *     created a Domain dataset group with a recommender for a domain use case.</p>
      */
     recommenderArn?: string;
+    /**
+     * <p>The promotions to apply to the recommendation request.
+     *       A promotion defines additional business rules that apply to a configurable subset of recommended items.</p>
+     */
+    promotions?: Promotion[];
 }
 export interface GetRecommendationsResponse {
     /**
@@ -162,6 +202,10 @@ export declare const PredictedItemFilterSensitiveLog: (obj: PredictedItem) => an
  * @internal
  */
 export declare const GetPersonalizedRankingResponseFilterSensitiveLog: (obj: GetPersonalizedRankingResponse) => any;
+/**
+ * @internal
+ */
+export declare const PromotionFilterSensitiveLog: (obj: Promotion) => any;
 /**
  * @internal
  */

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

@@ -20,6 +20,8 @@ export interface PredictedItem {
     itemId?: string;
     
     score?: number;
+    
+    promotionName?: string;
 }
 export interface GetPersonalizedRankingResponse {
     
@@ -41,6 +43,17 @@ export declare class ResourceNotFoundException extends __BaseException {
     
     constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
 }
+
+export interface Promotion {
+    
+    name?: string;
+    
+    percentPromotedItems?: number;
+    
+    filterArn?: string;
+    
+    filterValues?: Record<string, string>;
+}
 export interface GetRecommendationsRequest {
     
     campaignArn?: string;
@@ -58,6 +71,8 @@ export interface GetRecommendationsRequest {
     filterValues?: Record<string, string>;
     
     recommenderArn?: string;
+    
+    promotions?: Promotion[];
 }
 export interface GetRecommendationsResponse {
     
@@ -72,6 +87,8 @@ export declare const PredictedItemFilterSensitiveLog: (obj: PredictedItem) => an
 
 export declare const GetPersonalizedRankingResponseFilterSensitiveLog: (obj: GetPersonalizedRankingResponse) => any;
 
+export declare const PromotionFilterSensitiveLog: (obj: Promotion) => any;
+
 export declare const GetRecommendationsRequestFilterSensitiveLog: (obj: GetRecommendationsRequest) => any;
 
 export declare const GetRecommendationsResponseFilterSensitiveLog: (obj: GetRecommendationsResponse) => any;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-personalize-runtime",
   "description": "AWS SDK for JavaScript Personalize Runtime Client for Node.js, Browser and React Native",
-  "version": "3.141.0",
+  "version": "3.149.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -18,9 +18,9 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "2.0.0",
     "@aws-crypto/sha256-js": "2.0.0",
-    "@aws-sdk/client-sts": "3.141.0",
+    "@aws-sdk/client-sts": "3.145.0",
     "@aws-sdk/config-resolver": "3.130.0",
-    "@aws-sdk/credential-provider-node": "3.141.0",
+    "@aws-sdk/credential-provider-node": "3.145.0",
     "@aws-sdk/fetch-http-handler": "3.131.0",
     "@aws-sdk/hash-node": "3.127.0",
     "@aws-sdk/invalid-dependency": "3.127.0",
@@ -36,15 +36,15 @@
     "@aws-sdk/node-config-provider": "3.127.0",
     "@aws-sdk/node-http-handler": "3.127.0",
     "@aws-sdk/protocol-http": "3.127.0",
-    "@aws-sdk/smithy-client": "3.137.0",
+    "@aws-sdk/smithy-client": "3.142.0",
     "@aws-sdk/types": "3.127.0",
     "@aws-sdk/url-parser": "3.127.0",
     "@aws-sdk/util-base64-browser": "3.109.0",
     "@aws-sdk/util-base64-node": "3.55.0",
     "@aws-sdk/util-body-length-browser": "3.55.0",
     "@aws-sdk/util-body-length-node": "3.55.0",
-    "@aws-sdk/util-defaults-mode-browser": "3.137.0",
-    "@aws-sdk/util-defaults-mode-node": "3.137.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.142.0",
+    "@aws-sdk/util-defaults-mode-node": "3.142.0",
     "@aws-sdk/util-user-agent-browser": "3.127.0",
     "@aws-sdk/util-user-agent-node": "3.127.0",
     "@aws-sdk/util-utf8-browser": "3.109.0",
@@ -61,6 +61,11 @@
     "typedoc": "0.19.2",
     "typescript": "~4.6.2"
   },
+  "overrides": {
+    "typedoc": {
+      "typescript": "~4.6.2"
+    }
+  },
   "engines": {
     "node": ">=12.0.0"
   },