lib-storage

# 🟡 Community Browser CDN Build – JavaScript SDK Client Package This repository provides a **community-maintained, browser-ready distribution** of the npm module `@aws-sdk/lib-storage`. It is part of a larger collection (`cloud-sdk-builds`) that offers prebuilt versions of various AWS SDK for JavaScript v3 packages. ## Key Features - **Zero Build Steps**: Packages are automatically built and published to a CDN. Developers can use the SDK client directly in browsers without needing Webpack, Vite, or other bundlers. - **CDN Hosting**: Hosted on jsDelivr, allowing easy integration via HTML `<script type="importmap">`. - **Version Pinning**: Supports specific version URLs to ensure stability in production environments. - **SRI Integrity**: Provides Subresource Integrity (SRI) hashes for secure loading. ## Usage ### Import Map Setup To use the package, define an import map in your HTML: ```html <script type="importmap"> { "imports": { "@aws-sdk/lib-storage": "https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs" }, "integrity": { "https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs": "sha384-nNlqFhRJ+qNESYQLM/aNxDE11EPiRpG+tqDNwmLQJ5AZuG6ZdxFUCm5mEXj/9F5a" } } </script> ``` ### Direct Import Once configured, you can import the module in your JavaScript: ```javascript import { ... } from "@aws-sdk/lib-storage"; ``` ## Available Packages Any official `@aws-sdk/*` module published on npm can be built for browser CDN usage. The pattern for URLs is: - **Latest Version**: `https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}/index.min.mjs` - **Specific Version**: `https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}@{aws_version}/index.min.mjs` Replace `{aws_service_name}` with the service name (e.g., `client-s3`, `lib-storage`) and `{aws_version}` with the desired version tag. ## Security & Best Practices - **Pin Versions**: Always pin to a specific version (e.g., `@3.1131.0`) in production to avoid unexpected breaking changes from updates. - **Avoid Latest**: Do not use the `latest` URL in production environments. - **Verify SRI**: Use the provided SHA integrity hash to ensure the content has not been tampered with. ## Disclaimer This project is a **community-operated distribution** and is **not affiliated with, endorsed by, or sponsored by** Amazon Web Services or the official SDK maintainers. All original SDK source code remains licensed under its respective upstream license. ## Contributing If you need support for additional browser-ready SDK packages, please open an issue at the main organization's issue tracker: `https://github.com/cloud-sdk-builds/.github/issues`.