@aws-sdk/client-personalize-runtime 3.378.0 → 3.382.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,7 @@
1
1
  import { Endpoint, EndpointParameters as __EndpointParameters, EndpointV2, Provider } from "@smithy/types";
2
+ /**
3
+ * @public
4
+ */
2
5
  export interface ClientInputEndpointParameters {
3
6
  region?: string | Provider<string>;
4
7
  useDualstackEndpoint?: boolean | Provider<boolean>;
@@ -5,6 +5,7 @@
5
5
  */
6
6
  export * from "./PersonalizeRuntimeClient";
7
7
  export * from "./PersonalizeRuntime";
8
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
8
9
  export * from "./commands";
9
10
  export * from "./models";
10
11
  export { PersonalizeRuntimeServiceException } from "./models/PersonalizeRuntimeServiceException";
@@ -5,32 +5,38 @@ import { PersonalizeRuntimeServiceException as __BaseException } from "./Persona
5
5
  */
6
6
  export interface GetPersonalizedRankingRequest {
7
7
  /**
8
+ * @public
8
9
  * <p>The Amazon Resource Name (ARN) of the campaign to use for generating the personalized
9
10
  * ranking.</p>
10
11
  */
11
12
  campaignArn: string | undefined;
12
13
  /**
14
+ * @public
13
15
  * <p>A list of items (by <code>itemId</code>) to rank. If an item was not included in the training dataset,
14
16
  * the item is appended to the end of the reranked list. The maximum is 500.</p>
15
17
  */
16
18
  inputList: string[] | undefined;
17
19
  /**
20
+ * @public
18
21
  * <p>The user for which you want the campaign to provide a personalized ranking.</p>
19
22
  */
20
23
  userId: string | undefined;
21
24
  /**
25
+ * @public
22
26
  * <p>The contextual metadata to use when getting recommendations. Contextual metadata includes
23
27
  * any interaction information that might be relevant when getting a user's recommendations, such
24
28
  * as the user's current location or device type.</p>
25
29
  */
26
30
  context?: Record<string, string>;
27
31
  /**
32
+ * @public
28
33
  * <p>The Amazon Resource Name (ARN) of a filter you created to include items or exclude items from recommendations for a given user.
29
34
  * For more information, see
30
35
  * <a href="https://docs.aws.amazon.com/personalize/latest/dg/filter.html">Filtering Recommendations</a>.</p>
31
36
  */
32
37
  filterArn?: string;
33
38
  /**
39
+ * @public
34
40
  * <p>The values to use when filtering recommendations. For each placeholder parameter in your filter expression, provide the parameter name (in matching case)
35
41
  * as a key and the filter value(s) as the corresponding value. Separate multiple values for one parameter with a comma.
36
42
  * </p>
@@ -52,15 +58,18 @@ export interface GetPersonalizedRankingRequest {
52
58
  */
53
59
  export interface PredictedItem {
54
60
  /**
61
+ * @public
55
62
  * <p>The recommended item ID.</p>
56
63
  */
57
64
  itemId?: string;
58
65
  /**
66
+ * @public
59
67
  * <p>A numeric representation of the model's certainty that the item will be the next user
60
68
  * selection. For more information on scoring logic, see <a>how-scores-work</a>.</p>
61
69
  */
62
70
  score?: number;
63
71
  /**
72
+ * @public
64
73
  * <p>The name of the promotion that included the predicted item.</p>
65
74
  */
66
75
  promotionName?: string;
@@ -70,10 +79,12 @@ export interface PredictedItem {
70
79
  */
71
80
  export interface GetPersonalizedRankingResponse {
72
81
  /**
82
+ * @public
73
83
  * <p>A list of items in order of most likely interest to the user. The maximum is 500.</p>
74
84
  */
75
85
  personalizedRanking?: PredictedItem[];
76
86
  /**
87
+ * @public
77
88
  * <p>The ID of the recommendation.</p>
78
89
  */
79
90
  recommendationId?: string;
@@ -108,19 +119,23 @@ export declare class ResourceNotFoundException extends __BaseException {
108
119
  */
109
120
  export interface Promotion {
110
121
  /**
122
+ * @public
111
123
  * <p>The name of the promotion.</p>
112
124
  */
113
125
  name?: string;
114
126
  /**
127
+ * @public
115
128
  * <p>The percentage of recommended items to apply the promotion to.</p>
116
129
  */
117
130
  percentPromotedItems?: number;
118
131
  /**
132
+ * @public
119
133
  * <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
120
134
  * <a href="https://docs.aws.amazon.com/personalize/latest/dg/promoting-items.html#promotion-filters">Promotion filters</a>.</p>
121
135
  */
122
136
  filterArn?: string;
123
137
  /**
138
+ * @public
124
139
  * <p>The values to use when promoting items.
125
140
  * 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.
126
141
  * </p>
@@ -139,36 +154,43 @@ export interface Promotion {
139
154
  */
140
155
  export interface GetRecommendationsRequest {
141
156
  /**
157
+ * @public
142
158
  * <p>The Amazon Resource Name (ARN) of the campaign to use for getting recommendations.</p>
143
159
  */
144
160
  campaignArn?: string;
145
161
  /**
162
+ * @public
146
163
  * <p>The item ID to provide recommendations for.</p>
147
164
  * <p>Required for <code>RELATED_ITEMS</code> recipe type.</p>
148
165
  */
149
166
  itemId?: string;
150
167
  /**
168
+ * @public
151
169
  * <p>The user ID to provide recommendations for.</p>
152
170
  * <p>Required for <code>USER_PERSONALIZATION</code> recipe type.</p>
153
171
  */
154
172
  userId?: string;
155
173
  /**
174
+ * @public
156
175
  * <p>The number of results to return. The default is 25. The maximum is 500.</p>
157
176
  */
158
177
  numResults?: number;
159
178
  /**
179
+ * @public
160
180
  * <p>The contextual metadata to use when getting recommendations. Contextual metadata includes
161
181
  * any interaction information that might be relevant when getting a user's recommendations, such
162
182
  * as the user's current location or device type.</p>
163
183
  */
164
184
  context?: Record<string, string>;
165
185
  /**
186
+ * @public
166
187
  * <p>The ARN of the filter to apply to the returned recommendations. For more information, see
167
188
  * <a href="https://docs.aws.amazon.com/personalize/latest/dg/filter.html">Filtering Recommendations</a>.</p>
168
189
  * <p>When using this parameter, be sure the filter resource is <code>ACTIVE</code>.</p>
169
190
  */
170
191
  filterArn?: string;
171
192
  /**
193
+ * @public
172
194
  * <p>The values to use when filtering recommendations. For each placeholder parameter in your filter expression, provide the parameter name (in matching case)
173
195
  * as a key and the filter value(s) as the corresponding value. Separate multiple values for one parameter with a comma.
174
196
  * </p>
@@ -182,11 +204,13 @@ export interface GetRecommendationsRequest {
182
204
  */
183
205
  filterValues?: Record<string, string>;
184
206
  /**
207
+ * @public
185
208
  * <p>The Amazon Resource Name (ARN) of the recommender to use to get recommendations. Provide a recommender ARN if you
186
209
  * created a Domain dataset group with a recommender for a domain use case.</p>
187
210
  */
188
211
  recommenderArn?: string;
189
212
  /**
213
+ * @public
190
214
  * <p>The promotions to apply to the recommendation request.
191
215
  * A promotion defines additional business rules that apply to a configurable subset of recommended items.</p>
192
216
  */
@@ -197,11 +221,13 @@ export interface GetRecommendationsRequest {
197
221
  */
198
222
  export interface GetRecommendationsResponse {
199
223
  /**
224
+ * @public
200
225
  * <p>A list of recommendations sorted in descending order by prediction score. There can be a
201
226
  * maximum of 500 items in the list.</p>
202
227
  */
203
228
  itemList?: PredictedItem[];
204
229
  /**
230
+ * @public
205
231
  * <p>The ID of the recommendation.</p>
206
232
  */
207
233
  recommendationId?: string;
@@ -1,5 +1,6 @@
1
1
  export * from "./PersonalizeRuntimeClient";
2
2
  export * from "./PersonalizeRuntime";
3
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
3
4
  export * from "./commands";
4
5
  export * from "./models";
5
6
  export { PersonalizeRuntimeServiceException } from "./models/PersonalizeRuntimeServiceException";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-personalize-runtime",
3
3
  "description": "AWS SDK for JavaScript Personalize Runtime Client for Node.js, Browser and React Native",
4
- "version": "3.378.0",
4
+ "version": "3.382.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,15 +21,15 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "3.0.0",
23
23
  "@aws-crypto/sha256-js": "3.0.0",
24
- "@aws-sdk/client-sts": "3.378.0",
25
- "@aws-sdk/credential-provider-node": "3.378.0",
26
- "@aws-sdk/middleware-host-header": "3.378.0",
24
+ "@aws-sdk/client-sts": "3.382.0",
25
+ "@aws-sdk/credential-provider-node": "3.382.0",
26
+ "@aws-sdk/middleware-host-header": "3.379.1",
27
27
  "@aws-sdk/middleware-logger": "3.378.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.378.0",
29
- "@aws-sdk/middleware-signing": "3.378.0",
30
- "@aws-sdk/middleware-user-agent": "3.378.0",
29
+ "@aws-sdk/middleware-signing": "3.379.1",
30
+ "@aws-sdk/middleware-user-agent": "3.382.0",
31
31
  "@aws-sdk/types": "3.378.0",
32
- "@aws-sdk/util-endpoints": "3.378.0",
32
+ "@aws-sdk/util-endpoints": "3.382.0",
33
33
  "@aws-sdk/util-user-agent-browser": "3.378.0",
34
34
  "@aws-sdk/util-user-agent-node": "3.378.0",
35
35
  "@smithy/config-resolver": "^2.0.1",