@aws-sdk/client-groundstation 3.918.0 → 3.919.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.
Files changed (29) hide show
  1. package/README.md +1 -4
  2. package/dist-cjs/endpoint/ruleset.js +1 -1
  3. package/dist-cjs/index.js +169 -0
  4. package/dist-es/endpoint/ruleset.js +1 -1
  5. package/dist-es/models/models_0.js +88 -0
  6. package/dist-es/protocols/Aws_restJson1.js +80 -2
  7. package/dist-types/GroundStation.d.ts +1 -4
  8. package/dist-types/GroundStationClient.d.ts +1 -4
  9. package/dist-types/commands/CreateConfigCommand.d.ts +1 -2
  10. package/dist-types/commands/CreateDataflowEndpointGroupCommand.d.ts +1 -5
  11. package/dist-types/commands/CreateEphemerisCommand.d.ts +31 -2
  12. package/dist-types/commands/CreateMissionProfileCommand.d.ts +1 -4
  13. package/dist-types/commands/DeleteEphemerisCommand.d.ts +4 -1
  14. package/dist-types/commands/DescribeContactCommand.d.ts +11 -0
  15. package/dist-types/commands/DescribeEphemerisCommand.d.ts +15 -1
  16. package/dist-types/commands/GetAgentConfigurationCommand.d.ts +1 -4
  17. package/dist-types/commands/GetConfigCommand.d.ts +1 -2
  18. package/dist-types/commands/ListContactsCommand.d.ts +10 -4
  19. package/dist-types/commands/ListEphemeridesCommand.d.ts +4 -2
  20. package/dist-types/commands/RegisterAgentCommand.d.ts +1 -4
  21. package/dist-types/commands/ReserveContactCommand.d.ts +11 -1
  22. package/dist-types/commands/UpdateAgentStatusCommand.d.ts +1 -4
  23. package/dist-types/commands/UpdateConfigCommand.d.ts +1 -3
  24. package/dist-types/commands/UpdateEphemerisCommand.d.ts +1 -1
  25. package/dist-types/commands/UpdateMissionProfileCommand.d.ts +1 -3
  26. package/dist-types/index.d.ts +1 -4
  27. package/dist-types/models/models_0.d.ts +474 -167
  28. package/dist-types/ts3.4/models/models_0.d.ts +196 -8
  29. package/package.json +3 -3
@@ -202,10 +202,7 @@ export type GroundStationClientResolvedConfigType = __SmithyResolvedConfiguratio
202
202
  export interface GroundStationClientResolvedConfig extends GroundStationClientResolvedConfigType {
203
203
  }
204
204
  /**
205
- * <p>Welcome to the AWS Ground Station API Reference. AWS Ground Station is a fully managed service that
206
- * enables you to control satellite communications, downlink and process satellite data, and
207
- * scale your satellite operations efficiently and cost-effectively without having
208
- * to build or manage your own ground station infrastructure.</p>
205
+ * <p>Welcome to the AWS Ground Station API Reference. AWS Ground Station is a fully managed service that enables you to control satellite communications, downlink and process satellite data, and scale your satellite operations efficiently and cost-effectively without having to build or manage your own ground station infrastructure.</p>
209
206
  * @public
210
207
  */
211
208
  export declare class GroundStationClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, GroundStationClientResolvedConfig> {
@@ -27,8 +27,7 @@ declare const CreateConfigCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Creates a <code>Config</code> with the specified <code>configData</code> parameters.</p>
31
- * <p>Only one type of <code>configData</code> can be specified.</p>
30
+ * <p>Creates a <code>Config</code> with the specified <code>configData</code> parameters.</p> <p>Only one type of <code>configData</code> can be specified.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -27,11 +27,7 @@ declare const CreateDataflowEndpointGroupCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Creates a <code>DataflowEndpoint</code> group containing the specified list of <code>DataflowEndpoint</code> objects.</p>
31
- * <p>The <code>name</code> field in each endpoint is used in your mission profile <code>DataflowEndpointConfig</code>
32
- * to specify which endpoints to use during a contact.</p>
33
- * <p>When a contact uses multiple <code>DataflowEndpointConfig</code> objects, each <code>Config</code>
34
- * must match a <code>DataflowEndpoint</code> in the same group.</p>
30
+ * <p>Creates a <code>DataflowEndpoint</code> group containing the specified list of <code>DataflowEndpoint</code> objects.</p> <p>The <code>name</code> field in each endpoint is used in your mission profile <code>DataflowEndpointConfig</code> to specify which endpoints to use during a contact.</p> <p>When a contact uses multiple <code>DataflowEndpointConfig</code> objects, each <code>Config</code> must match a <code>DataflowEndpoint</code> in the same group.</p>
35
31
  * @example
36
32
  * Use a bare-bones client and the command you need to make an API call.
37
33
  * ```javascript
@@ -27,7 +27,7 @@ declare const CreateEphemerisCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Creates an Ephemeris with the specified <code>EphemerisData</code>.</p>
30
+ * <p>Create an ephemeris with your specified <a>EphemerisData</a>.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -37,7 +37,7 @@ declare const CreateEphemerisCommand_base: {
37
37
  * const config = {}; // type is GroundStationClientConfig
38
38
  * const client = new GroundStationClient(config);
39
39
  * const input = { // CreateEphemerisRequest
40
- * satelliteId: "STRING_VALUE", // required
40
+ * satelliteId: "STRING_VALUE",
41
41
  * enabled: true || false,
42
42
  * priority: Number("int"),
43
43
  * expirationTime: new Date("TIMESTAMP"),
@@ -69,6 +69,35 @@ declare const CreateEphemerisCommand_base: {
69
69
  * },
70
70
  * oemData: "STRING_VALUE",
71
71
  * },
72
+ * azEl: { // AzElEphemeris
73
+ * groundStation: "STRING_VALUE", // required
74
+ * data: { // AzElSegmentsData Union: only one key present
75
+ * s3Object: {
76
+ * bucket: "STRING_VALUE",
77
+ * key: "STRING_VALUE",
78
+ * version: "STRING_VALUE",
79
+ * },
80
+ * azElData: { // AzElSegments
81
+ * angleUnit: "DEGREE_ANGLE" || "RADIAN", // required
82
+ * azElSegmentList: [ // AzElSegmentList // required
83
+ * { // AzElSegment
84
+ * referenceEpoch: new Date("TIMESTAMP"), // required
85
+ * validTimeRange: { // ISO8601TimeRange
86
+ * startTime: new Date("TIMESTAMP"), // required
87
+ * endTime: new Date("TIMESTAMP"), // required
88
+ * },
89
+ * azElList: [ // TimeAzElList // required
90
+ * { // TimeAzEl
91
+ * dt: Number("double"), // required
92
+ * az: Number("double"), // required
93
+ * el: Number("double"), // required
94
+ * },
95
+ * ],
96
+ * },
97
+ * ],
98
+ * },
99
+ * },
100
+ * },
72
101
  * },
73
102
  * tags: { // TagsMap
74
103
  * "<keys>": "STRING_VALUE",
@@ -27,10 +27,7 @@ declare const CreateMissionProfileCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Creates a mission profile.</p>
31
- * <p>
32
- * <code>dataflowEdges</code> is a list of lists of strings. Each lower level list of strings
33
- * has two elements: a <i>from</i> ARN and a <i>to</i> ARN.</p>
30
+ * <p>Creates a mission profile.</p> <p> <code>dataflowEdges</code> is a list of lists of strings. Each lower level list of strings has two elements: a <i>from</i> ARN and a <i>to</i> ARN.</p>
34
31
  * @example
35
32
  * Use a bare-bones client and the command you need to make an API call.
36
33
  * ```javascript
@@ -27,7 +27,7 @@ declare const DeleteEphemerisCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Deletes an ephemeris</p>
30
+ * <p>Delete an ephemeris.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -59,6 +59,9 @@ declare const DeleteEphemerisCommand_base: {
59
59
  * @throws {@link InvalidParameterException} (client fault)
60
60
  * <p>One or more parameters are not valid.</p>
61
61
  *
62
+ * @throws {@link ResourceInUseException} (client fault)
63
+ * <p>The specified resource is in use by non-terminal state contacts and cannot be modified or deleted.</p>
64
+ *
62
65
  * @throws {@link ResourceNotFoundException} (client fault)
63
66
  * <p>Resource was not found.</p>
64
67
  *
@@ -187,6 +187,17 @@ declare const DescribeContactCommand_base: {
187
187
  * // ],
188
188
  * // visibilityStartTime: new Date("TIMESTAMP"),
189
189
  * // visibilityEndTime: new Date("TIMESTAMP"),
190
+ * // trackingOverrides: { // TrackingOverrides
191
+ * // programTrackSettings: { // ProgramTrackSettings Union: only one key present
192
+ * // azEl: { // AzElProgramTrackSettings
193
+ * // ephemerisId: "STRING_VALUE", // required
194
+ * // },
195
+ * // },
196
+ * // },
197
+ * // ephemeris: { // EphemerisResponseData
198
+ * // ephemerisId: "STRING_VALUE",
199
+ * // ephemerisType: "TLE" || "OEM" || "AZ_EL" || "SERVICE_MANAGED", // required
200
+ * // },
190
201
  * // };
191
202
  *
192
203
  * ```
@@ -27,7 +27,7 @@ declare const DescribeEphemerisCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Describes an existing ephemeris.</p>
30
+ * <p>Retrieve information about an existing ephemeris.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -69,8 +69,22 @@ declare const DescribeEphemerisCommand_base: {
69
69
  * // },
70
70
  * // ephemerisData: "STRING_VALUE",
71
71
  * // },
72
+ * // azEl: {
73
+ * // sourceS3Object: {
74
+ * // bucket: "STRING_VALUE",
75
+ * // key: "STRING_VALUE",
76
+ * // version: "STRING_VALUE",
77
+ * // },
78
+ * // ephemerisData: "STRING_VALUE",
79
+ * // },
72
80
  * // },
73
81
  * // invalidReason: "METADATA_INVALID" || "TIME_RANGE_INVALID" || "TRAJECTORY_INVALID" || "KMS_KEY_INVALID" || "VALIDATION_ERROR",
82
+ * // errorReasons: [ // EphemerisErrorReasonList
83
+ * // { // EphemerisErrorReason
84
+ * // errorCode: "INTERNAL_ERROR" || "MISMATCHED_SATCAT_ID" || "OEM_VERSION_UNSUPPORTED" || "ORIGINATOR_MISSING" || "CREATION_DATE_MISSING" || "OBJECT_NAME_MISSING" || "OBJECT_ID_MISSING" || "REF_FRAME_UNSUPPORTED" || "REF_FRAME_EPOCH_UNSUPPORTED" || "TIME_SYSTEM_UNSUPPORTED" || "CENTER_BODY_UNSUPPORTED" || "INTERPOLATION_MISSING" || "INTERPOLATION_DEGREE_INVALID" || "AZ_EL_SEGMENT_LIST_MISSING" || "INSUFFICIENT_TIME_AZ_EL" || "START_TIME_IN_FUTURE" || "END_TIME_IN_PAST" || "EXPIRATION_TIME_TOO_EARLY" || "START_TIME_METADATA_TOO_EARLY" || "STOP_TIME_METADATA_TOO_LATE" || "AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME" || "AZ_EL_SEGMENT_TIMES_OVERLAP" || "AZ_EL_SEGMENTS_OUT_OF_ORDER" || "TIME_AZ_EL_ITEMS_OUT_OF_ORDER" || "MEAN_MOTION_INVALID" || "TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID" || "TIME_AZ_EL_EL_RADIAN_RANGE_INVALID" || "TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID" || "TIME_AZ_EL_EL_DEGREE_RANGE_INVALID" || "TIME_AZ_EL_ANGLE_UNITS_INVALID" || "INSUFFICIENT_KMS_PERMISSIONS" || "FILE_FORMAT_INVALID" || "AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID" || "AZ_EL_SEGMENT_START_TIME_INVALID" || "AZ_EL_SEGMENT_END_TIME_INVALID" || "AZ_EL_SEGMENT_VALID_TIME_RANGE_INVALID" || "AZ_EL_SEGMENT_END_TIME_TOO_LATE" || "AZ_EL_TOTAL_DURATION_EXCEEDED", // required
85
+ * // errorMessage: "STRING_VALUE", // required
86
+ * // },
87
+ * // ],
74
88
  * // };
75
89
  *
76
90
  * ```
@@ -27,10 +27,7 @@ declare const GetAgentConfigurationCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note>
31
- * <p> For use by AWS Ground Station Agent and shouldn't be called directly.</p>
32
- * </note>
33
- * <p>Gets the latest configuration information for a registered agent.</p>
30
+ * <note> <p> For use by AWS Ground Station Agent and shouldn't be called directly.</p> </note> <p>Gets the latest configuration information for a registered agent.</p>
34
31
  * @example
35
32
  * Use a bare-bones client and the command you need to make an API call.
36
33
  * ```javascript
@@ -27,8 +27,7 @@ declare const GetConfigCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns <code>Config</code> information.</p>
31
- * <p>Only one <code>Config</code> response can be returned.</p>
30
+ * <p>Returns <code>Config</code> information.</p> <p>Only one <code>Config</code> response can be returned.</p>
32
31
  * @example
33
32
  * Use a bare-bones client and the command you need to make an API call.
34
33
  * ```javascript
@@ -27,10 +27,7 @@ declare const ListContactsCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Returns a list of contacts.</p>
31
- * <p>If <code>statusList</code> contains AVAILABLE, the request must include
32
- * <code>groundStation</code>, <code>missionprofileArn</code>, and <code>satelliteArn</code>.
33
- * </p>
30
+ * <p>Returns a list of contacts.</p> <p>If <code>statusList</code> contains AVAILABLE, the request must include <code>groundStation</code>, <code>missionprofileArn</code>, and <code>satelliteArn</code>. </p>
34
31
  * @example
35
32
  * Use a bare-bones client and the command you need to make an API call.
36
33
  * ```javascript
@@ -50,6 +47,11 @@ declare const ListContactsCommand_base: {
50
47
  * groundStation: "STRING_VALUE",
51
48
  * satelliteArn: "STRING_VALUE",
52
49
  * missionProfileArn: "STRING_VALUE",
50
+ * ephemeris: { // EphemerisFilter Union: only one key present
51
+ * azEl: { // AzElEphemerisFilter
52
+ * id: "STRING_VALUE", // required
53
+ * },
54
+ * },
53
55
  * };
54
56
  * const command = new ListContactsCommand(input);
55
57
  * const response = await client.send(command);
@@ -77,6 +79,10 @@ declare const ListContactsCommand_base: {
77
79
  * // },
78
80
  * // visibilityStartTime: new Date("TIMESTAMP"),
79
81
  * // visibilityEndTime: new Date("TIMESTAMP"),
82
+ * // ephemeris: { // EphemerisResponseData
83
+ * // ephemerisId: "STRING_VALUE",
84
+ * // ephemerisType: "TLE" || "OEM" || "AZ_EL" || "SERVICE_MANAGED", // required
85
+ * // },
80
86
  * // },
81
87
  * // ],
82
88
  * // };
@@ -27,7 +27,7 @@ declare const ListEphemeridesCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>List existing ephemerides.</p>
30
+ * <p>List your existing ephemerides.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -37,7 +37,8 @@ declare const ListEphemeridesCommand_base: {
37
37
  * const config = {}; // type is GroundStationClientConfig
38
38
  * const client = new GroundStationClient(config);
39
39
  * const input = { // ListEphemeridesRequest
40
- * satelliteId: "STRING_VALUE", // required
40
+ * satelliteId: "STRING_VALUE",
41
+ * ephemerisType: "TLE" || "OEM" || "AZ_EL" || "SERVICE_MANAGED",
41
42
  * startTime: new Date("TIMESTAMP"), // required
42
43
  * endTime: new Date("TIMESTAMP"), // required
43
44
  * statusList: [ // EphemerisStatusList
@@ -53,6 +54,7 @@ declare const ListEphemeridesCommand_base: {
53
54
  * // ephemerides: [ // EphemeridesList
54
55
  * // { // EphemerisItem
55
56
  * // ephemerisId: "STRING_VALUE",
57
+ * // ephemerisType: "TLE" || "OEM" || "AZ_EL" || "SERVICE_MANAGED",
56
58
  * // status: "VALIDATING" || "INVALID" || "ERROR" || "ENABLED" || "DISABLED" || "EXPIRED",
57
59
  * // priority: Number("int"),
58
60
  * // enabled: true || false,
@@ -27,10 +27,7 @@ declare const RegisterAgentCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note>
31
- * <p> For use by AWS Ground Station Agent and shouldn't be called directly.</p>
32
- * </note>
33
- * <p> Registers a new agent with AWS Ground Station. </p>
30
+ * <note> <p> For use by AWS Ground Station Agent and shouldn't be called directly.</p> </note> <p> Registers a new agent with AWS Ground Station. </p>
34
31
  * @example
35
32
  * Use a bare-bones client and the command you need to make an API call.
36
33
  * ```javascript
@@ -38,13 +38,20 @@ declare const ReserveContactCommand_base: {
38
38
  * const client = new GroundStationClient(config);
39
39
  * const input = { // ReserveContactRequest
40
40
  * missionProfileArn: "STRING_VALUE", // required
41
- * satelliteArn: "STRING_VALUE", // required
41
+ * satelliteArn: "STRING_VALUE",
42
42
  * startTime: new Date("TIMESTAMP"), // required
43
43
  * endTime: new Date("TIMESTAMP"), // required
44
44
  * groundStation: "STRING_VALUE", // required
45
45
  * tags: { // TagsMap
46
46
  * "<keys>": "STRING_VALUE",
47
47
  * },
48
+ * trackingOverrides: { // TrackingOverrides
49
+ * programTrackSettings: { // ProgramTrackSettings Union: only one key present
50
+ * azEl: { // AzElProgramTrackSettings
51
+ * ephemerisId: "STRING_VALUE", // required
52
+ * },
53
+ * },
54
+ * },
48
55
  * };
49
56
  * const command = new ReserveContactCommand(input);
50
57
  * const response = await client.send(command);
@@ -66,6 +73,9 @@ declare const ReserveContactCommand_base: {
66
73
  * @throws {@link InvalidParameterException} (client fault)
67
74
  * <p>One or more parameters are not valid.</p>
68
75
  *
76
+ * @throws {@link ResourceLimitExceededException} (client fault)
77
+ * <p>Account limits for this resource have been exceeded.</p>
78
+ *
69
79
  * @throws {@link ResourceNotFoundException} (client fault)
70
80
  * <p>Resource was not found.</p>
71
81
  *
@@ -27,10 +27,7 @@ declare const UpdateAgentStatusCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note>
31
- * <p> For use by AWS Ground Station Agent and shouldn't be called directly.</p>
32
- * </note>
33
- * <p>Update the status of the agent.</p>
30
+ * <note> <p> For use by AWS Ground Station Agent and shouldn't be called directly.</p> </note> <p>Update the status of the agent.</p>
34
31
  * @example
35
32
  * Use a bare-bones client and the command you need to make an API call.
36
33
  * ```javascript
@@ -27,9 +27,7 @@ declare const UpdateConfigCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Updates the <code>Config</code> used when scheduling contacts.</p>
31
- * <p>Updating a <code>Config</code> will not update the execution parameters
32
- * for existing future contacts scheduled with this <code>Config</code>.</p>
30
+ * <p>Updates the <code>Config</code> used when scheduling contacts.</p> <p>Updating a <code>Config</code> will not update the execution parameters for existing future contacts scheduled with this <code>Config</code>.</p>
33
31
  * @example
34
32
  * Use a bare-bones client and the command you need to make an API call.
35
33
  * ```javascript
@@ -27,7 +27,7 @@ declare const UpdateEphemerisCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Updates an existing ephemeris</p>
30
+ * <p>Update an existing ephemeris.</p>
31
31
  * @example
32
32
  * Use a bare-bones client and the command you need to make an API call.
33
33
  * ```javascript
@@ -27,9 +27,7 @@ declare const UpdateMissionProfileCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Updates a mission profile.</p>
31
- * <p>Updating a mission profile will not update the execution parameters
32
- * for existing future contacts.</p>
30
+ * <p>Updates a mission profile.</p> <p>Updating a mission profile will not update the execution parameters for existing future contacts.</p>
33
31
  * @example
34
32
  * Use a bare-bones client and the command you need to make an API call.
35
33
  * ```javascript
@@ -1,8 +1,5 @@
1
1
  /**
2
- * <p>Welcome to the AWS Ground Station API Reference. AWS Ground Station is a fully managed service that
3
- * enables you to control satellite communications, downlink and process satellite data, and
4
- * scale your satellite operations efficiently and cost-effectively without having
5
- * to build or manage your own ground station infrastructure.</p>
2
+ * <p>Welcome to the AWS Ground Station API Reference. AWS Ground Station is a fully managed service that enables you to control satellite communications, downlink and process satellite data, and scale your satellite operations efficiently and cost-effectively without having to build or manage your own ground station infrastructure.</p>
6
3
  *
7
4
  * @packageDocumentation
8
5
  */