chore(credential-providers): unavailable browser credential providers throw at runtime

Author: kuhe

packages/credential-providers/README.md

@@ -505,8 +505,7 @@ See [`fromSSO()`](#fromsso) fro more information
 
 ## `fromEnv()`
 
-- Not available in browser & native apps unless your code or bundler populates the
-  `process.env` global object.
+- Not available in browser & native apps
 
 ```javascript
 import { fromEnv } from "@aws-sdk/credential-providers"; // ES6 import

packages/credential-providers/src/fromEnv.ts

@@ -24,8 +24,5 @@ import { AwsCredentialIdentityProvider } from "@smithy/types";
  *   credentials: fromEnv(),
  * });
  * ```
- *
- * To use this in non-Node.js environments such as a browser, your code or
- * build system must populate the `process.env` global object.
  */
 export const fromEnv = (init?: FromEnvInit): AwsCredentialIdentityProvider => _fromEnv(init);

packages/credential-providers/src/index.browser.ts

@@ -2,6 +2,47 @@ export * from "./fromCognitoIdentity";
 export * from "./fromCognitoIdentityPool";
 export { fromHttp } from "@aws-sdk/credential-provider-http";
 export type { FromHttpOptions, HttpProviderCredentials } from "@aws-sdk/credential-provider-http";
-export * from "./fromEnv";
 export * from "./fromTemporaryCredentials";
 export * from "./fromWebToken";
+
+export const fromContainerMetadata = async () => {
+  notAvailable("fromContainerMetadata");
+};
+
+export const fromEnv = async () => {
+  notAvailable("fromEnv");
+};
+
+export const fromIni = async () => {
+  notAvailable("fromIni");
+};
+
+export const fromInstanceMetadata = async () => {
+  notAvailable("fromInstanceMetadata");
+};
+
+export const fromNodeProviderChain = async () => {
+  notAvailable("fromNodeProviderChain");
+};
+
+export const fromProcess = async () => {
+  notAvailable("fromProcess");
+};
+
+export const fromSSO = async () => {
+  notAvailable("fromSSO");
+};
+
+export const fromTokenFile = async () => {
+  notAvailable("fromTokenFile");
+};
+
+/**
+ * @internal
+ */
+const notAvailable = (name: string): never => {
+  throw new Error(
+    `${name} is not available in the browser mode or similar environment.
+See https://www.npmjs.com/package/@aws-sdk/credential-providers for usage.`
+  );
+};