@aws-sdk/client-dynamodb-streams 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>;
@@ -9,6 +9,7 @@
9
9
  */
10
10
  export * from "./DynamoDBStreamsClient";
11
11
  export * from "./DynamoDBStreams";
12
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
12
13
  export * from "./commands";
13
14
  export * from "./models";
14
15
  export { DynamoDBStreamsServiceException } from "./models/DynamoDBStreamsServiceException";
@@ -6,14 +6,17 @@ import { DynamoDBStreamsServiceException as __BaseException } from "./DynamoDBSt
6
6
  */
7
7
  export interface DescribeStreamInput {
8
8
  /**
9
+ * @public
9
10
  * <p>The Amazon Resource Name (ARN) for the stream.</p>
10
11
  */
11
12
  StreamArn: string | undefined;
12
13
  /**
14
+ * @public
13
15
  * <p>The maximum number of shard objects to return. The upper limit is 100.</p>
14
16
  */
15
17
  Limit?: number;
16
18
  /**
19
+ * @public
17
20
  * <p>The shard ID of the first item that this operation will evaluate. Use the value that was
18
21
  * returned for <code>LastEvaluatedShardId</code> in the previous operation. </p>
19
22
  */
@@ -47,10 +50,12 @@ export type KeyType = (typeof KeyType)[keyof typeof KeyType];
47
50
  */
48
51
  export interface KeySchemaElement {
49
52
  /**
53
+ * @public
50
54
  * <p>The name of a key attribute.</p>
51
55
  */
52
56
  AttributeName: string | undefined;
53
57
  /**
58
+ * @public
54
59
  * <p>The role that this key attribute will assume:</p>
55
60
  * <ul>
56
61
  * <li>
@@ -81,10 +86,12 @@ export interface KeySchemaElement {
81
86
  */
82
87
  export interface SequenceNumberRange {
83
88
  /**
89
+ * @public
84
90
  * <p>The first sequence number for the stream records contained within a shard. String contains numeric characters only.</p>
85
91
  */
86
92
  StartingSequenceNumber?: string;
87
93
  /**
94
+ * @public
88
95
  * <p>The last sequence number for the stream records contained within a shard. String contains numeric characters only.</p>
89
96
  */
90
97
  EndingSequenceNumber?: string;
@@ -95,14 +102,17 @@ export interface SequenceNumberRange {
95
102
  */
96
103
  export interface Shard {
97
104
  /**
105
+ * @public
98
106
  * <p>The system-generated identifier for this shard.</p>
99
107
  */
100
108
  ShardId?: string;
101
109
  /**
110
+ * @public
102
111
  * <p>The range of possible sequence numbers for the shard.</p>
103
112
  */
104
113
  SequenceNumberRange?: SequenceNumberRange;
105
114
  /**
115
+ * @public
106
116
  * <p>The shard ID of the current shard's parent.</p>
107
117
  */
108
118
  ParentShardId?: string;
@@ -141,10 +151,12 @@ export type StreamViewType = (typeof StreamViewType)[keyof typeof StreamViewType
141
151
  */
142
152
  export interface StreamDescription {
143
153
  /**
154
+ * @public
144
155
  * <p>The Amazon Resource Name (ARN) for the stream.</p>
145
156
  */
146
157
  StreamArn?: string;
147
158
  /**
159
+ * @public
148
160
  * <p>A timestamp, in ISO 8601 format, for this stream.</p>
149
161
  * <p>Note that <code>LatestStreamLabel</code> is not a unique identifier for the stream, because it is
150
162
  * possible that a stream from another table might have the same timestamp. However, the
@@ -164,6 +176,7 @@ export interface StreamDescription {
164
176
  */
165
177
  StreamLabel?: string;
166
178
  /**
179
+ * @public
167
180
  * <p>Indicates the current status of the stream:</p>
168
181
  * <ul>
169
182
  * <li>
@@ -186,6 +199,7 @@ export interface StreamDescription {
186
199
  */
187
200
  StreamStatus?: StreamStatus | string;
188
201
  /**
202
+ * @public
189
203
  * <p>Indicates the format of the records within this stream:</p>
190
204
  * <ul>
191
205
  * <li>
@@ -208,22 +222,27 @@ export interface StreamDescription {
208
222
  */
209
223
  StreamViewType?: StreamViewType | string;
210
224
  /**
225
+ * @public
211
226
  * <p>The date and time when the request to create this stream was issued.</p>
212
227
  */
213
228
  CreationRequestDateTime?: Date;
214
229
  /**
230
+ * @public
215
231
  * <p>The DynamoDB table with which the stream is associated.</p>
216
232
  */
217
233
  TableName?: string;
218
234
  /**
235
+ * @public
219
236
  * <p>The key attribute(s) of the stream's DynamoDB table.</p>
220
237
  */
221
238
  KeySchema?: KeySchemaElement[];
222
239
  /**
240
+ * @public
223
241
  * <p>The shards that comprise the stream.</p>
224
242
  */
225
243
  Shards?: Shard[];
226
244
  /**
245
+ * @public
227
246
  * <p>The shard ID of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.</p>
228
247
  * <p>If <code>LastEvaluatedShardId</code> is empty, then the "last page" of results has been
229
248
  * processed and there is currently no more data to be retrieved.</p>
@@ -239,6 +258,7 @@ export interface StreamDescription {
239
258
  */
240
259
  export interface DescribeStreamOutput {
241
260
  /**
261
+ * @public
242
262
  * <p>A complete description of the stream, including its creation date and time, the DynamoDB table associated with the stream, the shard IDs within the stream, and the beginning and ending sequence numbers of stream records within the shards.</p>
243
263
  */
244
264
  StreamDescription?: StreamDescription;
@@ -289,10 +309,12 @@ export declare class ExpiredIteratorException extends __BaseException {
289
309
  */
290
310
  export interface GetRecordsInput {
291
311
  /**
312
+ * @public
292
313
  * <p>A shard iterator that was retrieved from a previous GetShardIterator operation. This iterator can be used to access the stream records in this shard.</p>
293
314
  */
294
315
  ShardIterator: string | undefined;
295
316
  /**
317
+ * @public
296
318
  * <p>The maximum number of records to return from the shard. The upper limit is 1000.</p>
297
319
  */
298
320
  Limit?: number;
@@ -316,11 +338,13 @@ export type OperationType = (typeof OperationType)[keyof typeof OperationType];
316
338
  */
317
339
  export interface Identity {
318
340
  /**
341
+ * @public
319
342
  * <p>A unique identifier for the entity that made the call. For Time To Live, the
320
343
  * principalId is "dynamodb.amazonaws.com".</p>
321
344
  */
322
345
  PrincipalId?: string;
323
346
  /**
347
+ * @public
324
348
  * <p>The type of the identity. For Time To Live, the type is "Service".</p>
325
349
  */
326
350
  Type?: string;
@@ -393,14 +417,17 @@ export type ShardIteratorType = (typeof ShardIteratorType)[keyof typeof ShardIte
393
417
  */
394
418
  export interface GetShardIteratorInput {
395
419
  /**
420
+ * @public
396
421
  * <p>The Amazon Resource Name (ARN) for the stream.</p>
397
422
  */
398
423
  StreamArn: string | undefined;
399
424
  /**
425
+ * @public
400
426
  * <p>The identifier of the shard. The iterator will be returned for this shard ID.</p>
401
427
  */
402
428
  ShardId: string | undefined;
403
429
  /**
430
+ * @public
404
431
  * <p>Determines how the shard iterator is used to start reading stream records from the shard:</p>
405
432
  * <ul>
406
433
  * <li>
@@ -429,6 +456,7 @@ export interface GetShardIteratorInput {
429
456
  */
430
457
  ShardIteratorType: ShardIteratorType | string | undefined;
431
458
  /**
459
+ * @public
432
460
  * <p>The sequence number of a stream record in the shard from which to start reading.</p>
433
461
  */
434
462
  SequenceNumber?: string;
@@ -439,6 +467,7 @@ export interface GetShardIteratorInput {
439
467
  */
440
468
  export interface GetShardIteratorOutput {
441
469
  /**
470
+ * @public
442
471
  * <p>The position in the shard from which to start reading stream records sequentially. A shard iterator specifies this position using the sequence number of a stream record in a shard.</p>
443
472
  */
444
473
  ShardIterator?: string;
@@ -449,14 +478,17 @@ export interface GetShardIteratorOutput {
449
478
  */
450
479
  export interface ListStreamsInput {
451
480
  /**
481
+ * @public
452
482
  * <p>If this parameter is provided, then only the streams associated with this table name are returned.</p>
453
483
  */
454
484
  TableName?: string;
455
485
  /**
486
+ * @public
456
487
  * <p>The maximum number of streams to return. The upper limit is 100.</p>
457
488
  */
458
489
  Limit?: number;
459
490
  /**
491
+ * @public
460
492
  * <p>The ARN (Amazon Resource Name) of the first item that this operation will evaluate. Use the
461
493
  * value that was returned for <code>LastEvaluatedStreamArn</code> in the previous operation.
462
494
  * </p>
@@ -469,14 +501,17 @@ export interface ListStreamsInput {
469
501
  */
470
502
  export interface _Stream {
471
503
  /**
504
+ * @public
472
505
  * <p>The Amazon Resource Name (ARN) for the stream.</p>
473
506
  */
474
507
  StreamArn?: string;
475
508
  /**
509
+ * @public
476
510
  * <p>The DynamoDB table with which the stream is associated.</p>
477
511
  */
478
512
  TableName?: string;
479
513
  /**
514
+ * @public
480
515
  * <p>A timestamp, in ISO 8601 format, for this stream.</p>
481
516
  * <p>Note that <code>LatestStreamLabel</code> is not a unique identifier for the stream, because it is
482
517
  * possible that a stream from another table might have the same timestamp. However, the
@@ -502,10 +537,12 @@ export interface _Stream {
502
537
  */
503
538
  export interface ListStreamsOutput {
504
539
  /**
540
+ * @public
505
541
  * <p>A list of stream descriptors associated with the current account and endpoint.</p>
506
542
  */
507
543
  Streams?: _Stream[];
508
544
  /**
545
+ * @public
509
546
  * <p>The stream ARN of the item where the operation stopped, inclusive of the previous result set. Use this value to start a new operation, excluding this value in the new request.</p>
510
547
  * <p>If <code>LastEvaluatedStreamArn</code> is empty, then the "last page" of results has been
511
548
  * processed and there is no more data to be retrieved.</p>
@@ -528,6 +565,7 @@ export type AttributeValue = AttributeValue.BMember | AttributeValue.BOOLMember
528
565
  */
529
566
  export declare namespace AttributeValue {
530
567
  /**
568
+ * @public
531
569
  * <p>An attribute of type String. For example:</p>
532
570
  * <p>
533
571
  * <code>"S": "Hello"</code>
@@ -547,6 +585,7 @@ export declare namespace AttributeValue {
547
585
  $unknown?: never;
548
586
  }
549
587
  /**
588
+ * @public
550
589
  * <p>An attribute of type Number. For example:</p>
551
590
  * <p>
552
591
  * <code>"N": "123.45"</code>
@@ -567,6 +606,7 @@ export declare namespace AttributeValue {
567
606
  $unknown?: never;
568
607
  }
569
608
  /**
609
+ * @public
570
610
  * <p>An attribute of type Binary. For example:</p>
571
611
  * <p>
572
612
  * <code>"B": "dGhpcyB0ZXh0IGlzIGJhc2U2NC1lbmNvZGVk"</code>
@@ -586,6 +626,7 @@ export declare namespace AttributeValue {
586
626
  $unknown?: never;
587
627
  }
588
628
  /**
629
+ * @public
589
630
  * <p>An attribute of type String Set. For example:</p>
590
631
  * <p>
591
632
  * <code>"SS": ["Giraffe", "Hippo" ,"Zebra"]</code>
@@ -605,6 +646,7 @@ export declare namespace AttributeValue {
605
646
  $unknown?: never;
606
647
  }
607
648
  /**
649
+ * @public
608
650
  * <p>An attribute of type Number Set. For example:</p>
609
651
  * <p>
610
652
  * <code>"NS": ["42.2", "-19", "7.5", "3.14"]</code>
@@ -625,6 +667,7 @@ export declare namespace AttributeValue {
625
667
  $unknown?: never;
626
668
  }
627
669
  /**
670
+ * @public
628
671
  * <p>An attribute of type Binary Set. For example:</p>
629
672
  * <p>
630
673
  * <code>"BS": ["U3Vubnk=", "UmFpbnk=", "U25vd3k="]</code>
@@ -644,6 +687,7 @@ export declare namespace AttributeValue {
644
687
  $unknown?: never;
645
688
  }
646
689
  /**
690
+ * @public
647
691
  * <p>An attribute of type Map. For example:</p>
648
692
  * <p>
649
693
  * <code>"M": \{"Name": \{"S": "Joe"\}, "Age": \{"N": "35"\}\}</code>
@@ -663,6 +707,7 @@ export declare namespace AttributeValue {
663
707
  $unknown?: never;
664
708
  }
665
709
  /**
710
+ * @public
666
711
  * <p>An attribute of type List. For example:</p>
667
712
  * <p>
668
713
  * <code>"L": [ \{"S": "Cookies"\} , \{"S": "Coffee"\}, \{"N": "3.14159"\}]</code>
@@ -682,6 +727,7 @@ export declare namespace AttributeValue {
682
727
  $unknown?: never;
683
728
  }
684
729
  /**
730
+ * @public
685
731
  * <p>An attribute of type Null. For example:</p>
686
732
  * <p>
687
733
  * <code>"NULL": true</code>
@@ -701,6 +747,7 @@ export declare namespace AttributeValue {
701
747
  $unknown?: never;
702
748
  }
703
749
  /**
750
+ * @public
704
751
  * <p>An attribute of type Boolean. For example:</p>
705
752
  * <p>
706
753
  * <code>"BOOL": true</code>
@@ -719,6 +766,9 @@ export declare namespace AttributeValue {
719
766
  BOOL: boolean;
720
767
  $unknown?: never;
721
768
  }
769
+ /**
770
+ * @public
771
+ */
722
772
  interface $UnknownMember {
723
773
  S?: never;
724
774
  N?: never;
@@ -753,30 +803,37 @@ export declare namespace AttributeValue {
753
803
  */
754
804
  export interface StreamRecord {
755
805
  /**
806
+ * @public
756
807
  * <p>The approximate date and time when the stream record was created, in <a href="http://www.epochconverter.com/">UNIX epoch time</a> format and rounded down to the closest second.</p>
757
808
  */
758
809
  ApproximateCreationDateTime?: Date;
759
810
  /**
811
+ * @public
760
812
  * <p>The primary key attribute(s) for the DynamoDB item that was modified.</p>
761
813
  */
762
814
  Keys?: Record<string, AttributeValue>;
763
815
  /**
816
+ * @public
764
817
  * <p>The item in the DynamoDB table as it appeared after it was modified.</p>
765
818
  */
766
819
  NewImage?: Record<string, AttributeValue>;
767
820
  /**
821
+ * @public
768
822
  * <p>The item in the DynamoDB table as it appeared before it was modified.</p>
769
823
  */
770
824
  OldImage?: Record<string, AttributeValue>;
771
825
  /**
826
+ * @public
772
827
  * <p>The sequence number of the stream record.</p>
773
828
  */
774
829
  SequenceNumber?: string;
775
830
  /**
831
+ * @public
776
832
  * <p>The size of the stream record, in bytes.</p>
777
833
  */
778
834
  SizeBytes?: number;
779
835
  /**
836
+ * @public
780
837
  * <p>The type of data from the modified DynamoDB item that was captured in this stream record:</p>
781
838
  * <ul>
782
839
  * <li>
@@ -805,10 +862,12 @@ export interface StreamRecord {
805
862
  */
806
863
  export interface _Record {
807
864
  /**
865
+ * @public
808
866
  * <p>A globally unique identifier for the event that was recorded in this stream record.</p>
809
867
  */
810
868
  eventID?: string;
811
869
  /**
870
+ * @public
812
871
  * <p>The type of data modification that was performed on the DynamoDB table:</p>
813
872
  * <ul>
814
873
  * <li>
@@ -827,6 +886,7 @@ export interface _Record {
827
886
  */
828
887
  eventName?: OperationType | string;
829
888
  /**
889
+ * @public
830
890
  * <p>The version number of the stream record format. This number is updated whenever the structure of <code>Record</code> is modified.</p>
831
891
  * <p>Client applications must not assume that <code>eventVersion</code> will remain at a particular
832
892
  * value, as this number is subject to change at any time. In general, <code>eventVersion</code> will
@@ -834,18 +894,22 @@ export interface _Record {
834
894
  */
835
895
  eventVersion?: string;
836
896
  /**
897
+ * @public
837
898
  * <p>The Amazon Web Services service from which the stream record originated. For DynamoDB Streams, this is <code>aws:dynamodb</code>.</p>
838
899
  */
839
900
  eventSource?: string;
840
901
  /**
902
+ * @public
841
903
  * <p>The region in which the <code>GetRecords</code> request was received.</p>
842
904
  */
843
905
  awsRegion?: string;
844
906
  /**
907
+ * @public
845
908
  * <p>The main body of the stream record, containing all of the DynamoDB-specific fields.</p>
846
909
  */
847
910
  dynamodb?: StreamRecord;
848
911
  /**
912
+ * @public
849
913
  * <p>Items that are deleted by the Time to Live process after expiration have the following fields: </p>
850
914
  * <ul>
851
915
  * <li>
@@ -866,10 +930,12 @@ export interface _Record {
866
930
  */
867
931
  export interface GetRecordsOutput {
868
932
  /**
933
+ * @public
869
934
  * <p>The stream records from the shard, which were retrieved using the shard iterator.</p>
870
935
  */
871
936
  Records?: _Record[];
872
937
  /**
938
+ * @public
873
939
  * <p>The next position in the shard from which to start sequentially reading stream records. If
874
940
  * set to <code>null</code>, the shard has been closed and the requested iterator will not return
875
941
  * any more data.</p>
@@ -1,5 +1,6 @@
1
1
  export * from "./DynamoDBStreamsClient";
2
2
  export * from "./DynamoDBStreams";
3
+ export { ClientInputEndpointParameters } from "./endpoint/EndpointParameters";
3
4
  export * from "./commands";
4
5
  export * from "./models";
5
6
  export { DynamoDBStreamsServiceException } from "./models/DynamoDBStreamsServiceException";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-dynamodb-streams",
3
3
  "description": "AWS SDK for JavaScript Dynamodb Streams 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",