@aws-sdk/core v3.679.0
@aws-sdk/core
This package provides common or core functionality to the AWS SDK for JavaScript (v3).
You do not need to explicitly install this package, since it will be transitively installed by AWS SDK clients.
@aws-sdk/core
submodules
Core submodules are organized for distribution via the package.json
exports
field.
exports
is supported by default by the latest Node.js, webpack, and esbuild. For react-native, it can be
enabled via instructions found at reactnative.dev/blog.
Think of @aws-sdk/core
as a mono-package within the monorepo.
It preserves the benefits of modularization, for example to optimize Node.js initialization speed,
while making it easier to have a consistent version of core dependencies, reducing package sprawl when
installing an SDK client.
Guide for submodules
- Each
index.ts
file corresponding to the pattern./src/submodules/<MODULE_NAME>/index.ts
will be published as a separatedist-cjs
bundled submodule index using theInliner.js
build script. - create a folder as
./src/submodules/<SUBMODULE>
including anindex.ts
file and aREADME.md
file.- The linter will throw an error on missing submodule metadata in
package.json
and the varioustsconfig.json
files, but it will automatically fix them if possible.
- The linter will throw an error on missing submodule metadata in
- a submodule is equivalent to a standalone
@aws-sdk/<pkg>
package in that importing it in Node.js will resolve a separate bundle. - submodules may not relatively import files from other submodules. Instead, directly use the
@scope/pkg/submodule
name as the import.- The linter will check for this and throw an error.
- To the extent possible, correctly declaring submodule metadata is validated by the linter in
@aws-sdk/core
. The linter runs duringyarn build
and also asyarn lint
.
When should I create an @aws-sdk/core/submodule
vs. @aws-sdk/new-package
?
Keep in mind that the core package is installed by all AWS SDK clients.
If the component functionality is upstream of multiple clients, it is a good candidate for a core submodule. For example, XML serialization.
If the component's functionality is downstream of a client, for example S3 pre-signing, it should be a standalone package with potentially a peer or runtime dependency on an AWS SDK client.
13 days ago
12 days ago
14 days ago
1 month ago
1 month ago
29 days ago
1 month ago
28 days ago
1 month ago
1 month ago
2 months ago
2 months ago
2 months ago
3 months ago
5 months ago
3 months ago
3 months ago
3 months ago
3 months ago
5 months ago
5 months ago
3 months ago
4 months ago
5 months ago
6 months ago
3 months ago
3 months ago
4 months ago
4 months ago
6 months ago
6 months ago
6 months ago
6 months ago
7 months ago
7 months ago
7 months ago
7 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
8 months ago
9 months ago
9 months ago
9 months ago
10 months ago
10 months ago
10 months ago
10 months ago
10 months ago
11 months ago
11 months ago
11 months ago
11 months ago
11 months ago
12 months ago
12 months ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago