alchemy 0.60.2 → 0.62.0

package/lib/aws/credentials.js

@@ -1 +1,149 @@
+import { alchemy } from "../alchemy.js";
+import { isSecret } from "../secret.js";
+/**
+ * Validate AWS client properties to ensure they are strings.
+ * This follows the same pattern as Cloudflare credential validation.
+ */
+function validateAwsClientProps(props, context) {
+    const validKeys = [
+        "accessKeyId",
+        "secretAccessKey",
+        "sessionToken",
+        "region",
+        "profile",
+        "roleArn",
+        "externalId",
+        "roleSessionName",
+    ];
+    for (const [key, value] of Object.entries(props)) {
+        if (!validKeys.includes(key)) {
+            continue; // Ignore unknown properties
+        }
+        if (value !== undefined && typeof value !== "string" && !isSecret(value)) {
+            throw new Error(`Invalid AWS configuration in ${context}: Property '${key}' must be a string or Secret, got ${typeof value}. ` +
+                "Please ensure all AWS credential properties are strings or Secret objects.");
+        }
+    }
+}
+/**
+ * Get global AWS configuration from environment variables.
+ * This provides the base layer of AWS credential configuration.
+ */
+export function getGlobalAwsConfig() {
+    return {
+        accessKeyId: process.env.AWS_ACCESS_KEY_ID
+            ? alchemy.secret(process.env.AWS_ACCESS_KEY_ID)
+            : undefined,
+        secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY
+            ? alchemy.secret(process.env.AWS_SECRET_ACCESS_KEY)
+            : undefined,
+        sessionToken: process.env.AWS_SESSION_TOKEN
+            ? alchemy.secret(process.env.AWS_SESSION_TOKEN)
+            : undefined,
+        region: process.env.AWS_REGION || process.env.AWS_DEFAULT_REGION,
+        profile: process.env.AWS_PROFILE,
+        roleArn: process.env.AWS_ROLE_ARN,
+        externalId: process.env.AWS_EXTERNAL_ID,
+        roleSessionName: process.env.AWS_ROLE_SESSION_NAME,
+    };
+}
+/**
+ * Resolve AWS credentials using three-tier resolution: global → scope → resource.
+ *
+ * This function implements a comprehensive credential resolution system that allows
+ * for flexible AWS credential management across different levels of your application.
+ * It enables multi-account and multi-region deployments by providing a consistent
+ * way to override credentials at different scopes.
+ *
+ * The resolution follows this precedence order:
+ * 1. Resource-level credentials (highest priority)
+ * 2. Scope-level credentials (medium priority)
+ * 3. Global environment variables (lowest priority)
+ *
+ * Supported credential properties include:
+ * - `region`: AWS region (e.g., 'us-west-2', 'eu-central-1')
+ * - `profile`: AWS profile name from credentials file
+ * - `accessKeyId`: AWS access key ID
+ * - `secretAccessKey`: AWS secret access key
+ * - `sessionToken`: AWS session token for temporary credentials
+ * - `roleArn`: AWS role ARN to assume
+ * - `roleSessionName`: Session name when assuming a role
+ * - `externalId`: External ID when assuming a role
+ *
+ * @param resourceProps - Resource-level AWS credential properties (optional)
+ * @returns Resolved AWS client properties with validation
+ *
+ * @throws {Error} When scope contains invalid AWS configuration
+ * @throws {Error} When resource properties contain invalid AWS configuration
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with resource-level credentials
+ * const credentials = resolveAwsCredentials({
+ *   region: "us-west-2",
+ *   profile: "production"
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Usage with scope-level credentials
+ * await alchemy.run("my-app", {
+ *   aws: {
+ *     region: "eu-west-1",
+ *     profile: "staging"
+ *   }
+ * }, async () => {
+ *   // Resources created here will use the scope credentials by default
+ *   const vpc = await Vpc("main-vpc", {
+ *     cidrBlock: "10.0.0.0/16"
+ *   });
+ *
+ *   // Resources can override scope credentials
+ *   const crossRegionSubnet = await Subnet("cross-region-subnet", {
+ *     vpc,
+ *     cidrBlock: "10.0.1.0/24",
+ *     region: "us-east-1" // Override scope region
+ *   });
+ * });
+ * ```
+ */
+export async function resolveAwsCredentials(resourceProps) {
+    // 1. Start with global environment variables (lowest priority)
+    const globalConfig = getGlobalAwsConfig();
+    // 2. Layer in scope-level credentials (medium priority)
+    let scopeConfig = {};
+    try {
+        // Import Scope dynamically to avoid circular dependency
+        const { Scope } = await import("../scope.js");
+        const currentScope = Scope.getScope();
+        if (currentScope?.providerCredentials?.aws) {
+            scopeConfig = currentScope.providerCredentials.aws;
+            // Validate scope-level credentials if provided
+            validateAwsClientProps(scopeConfig, "scope");
+        }
+    }
+    catch (error) {
+        // If we can't access scope (e.g., not running in scope context), just continue
+        // with empty scope config unless it's a validation error
+        if (error instanceof Error &&
+            error.message.includes("Invalid AWS configuration")) {
+            throw error;
+        }
+    }
+    // 3. Layer in resource-level credentials (highest priority)
+    const resourceConfig = resourceProps || {};
+    // Validate resource-level credentials if provided
+    if (resourceProps && Object.keys(resourceProps).length > 0) {
+        validateAwsClientProps(resourceProps, "resource properties");
+    }
+    // Merge configurations with proper precedence (later properties override earlier ones)
+    const resolvedConfig = {
+        ...globalConfig,
+        ...scopeConfig,
+        ...resourceConfig,
+    };
+    // Filter out undefined values from the final result
+    return Object.fromEntries(Object.entries(resolvedConfig).filter(([_, value]) => value !== undefined));
+}
 //# sourceMappingURL=credentials.js.map

package/lib/aws/credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/aws/credentials.ts"],"names":[],"mappings":""}
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/aws/credentials.ts"],"names":[],"mappings":"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"}

package/lib/aws/ec2/internet-gateway-attachment.d.ts

@@ -1,12 +1,13 @@
 import type { Context } from "../../context.ts";
 import { Resource } from "../../resource.ts";
 import { type TimeoutConfig } from "../../util/timeout.ts";
+import type { AwsClientProps } from "../client-props.ts";
 import type { InternetGateway } from "./internet-gateway.ts";
 import type { Vpc } from "./vpc.ts";
 /**
  * Properties for creating or updating an Internet Gateway Attachment
  */
-export interface InternetGatewayAttachmentProps {
+export interface InternetGatewayAttachmentProps extends AwsClientProps {
     /**
      * The Internet Gateway to attach
      */
@@ -50,6 +51,9 @@ export interface InternetGatewayAttachment extends Resource<"aws::InternetGatewa
  * allowing traffic to flow between the VPC and the internet when combined with proper
  * routing configuration.
  *
+ * Supports AWS credential overrides at the resource level, allowing you to deploy Internet Gateway Attachments
+ * to different AWS accounts or regions than the default scope configuration.
+ *
  * @example
  * // Basic Internet Gateway attachment for internet connectivity
  * const vpc = await Vpc("main-vpc", {
@@ -64,6 +68,36 @@ export interface InternetGatewayAttachment extends Resource<"aws::InternetGatewa
  * });
  *
  * @example
+ * // Internet Gateway Attachment with AWS credential overrides
+ * const crossAccountAttachment = await InternetGatewayAttachment("cross-account-attachment", {
+ *   internetGateway: igw,
+ *   vpc: vpc,
+ *   // Override AWS credentials for this specific resource
+ *   region: "us-east-1",
+ *   profile: "production-account",
+ * });
+ *
+ * @example
+ * // Internet Gateway Attachment in different region with role assumption
+ * const multiRegionAttachment = await InternetGatewayAttachment("multi-region-attachment", {
+ *   internetGateway: euIgw,
+ *   vpc: euVpc,
+ *   region: "eu-west-1",
+ *   roleArn: "arn:aws:iam::123456789012:role/CrossRegionRole",
+ *   roleSessionName: "igw-attachment-deployment",
+ * });
+ *
+ * @example
+ * // Internet Gateway Attachment with explicit credentials
+ * const explicitCredsAttachment = await InternetGatewayAttachment("explicit-creds-attachment", {
+ *   internetGateway: testIgw,
+ *   vpc: testVpc,
+ *   accessKeyId: alchemy.secret("AKIAIOSFODNN7EXAMPLE"),
+ *   secretAccessKey: alchemy.secret("wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"),
+ *   region: "us-west-2",
+ * });
+ *
+ * @example
  * // Internet Gateway attachment with custom timeout configuration
  * // for environments with slower AWS API responses
  * const attachment = await InternetGatewayAttachment("slow-env-attachment", {
@@ -92,7 +126,7 @@ export interface InternetGatewayAttachment extends Resource<"aws::InternetGatewa
  *
  * // Create public subnet and route table for internet access
  * const publicSubnet = await Subnet("public-subnet", {
- *   vpc,
+ *   vpc: vpc,
  *   cidrBlock: "10.0.1.0/24",
  *   availabilityZone: "us-east-1a"
  * });
@@ -104,7 +138,27 @@ export interface InternetGatewayAttachment extends Resource<"aws::InternetGatewa
  * const internetRoute = await Route("internet-route", {
  *   routeTable: publicRouteTable,
  *   destinationCidrBlock: "0.0.0.0/0",
- *   gateway: igw
+ *   target: { internetGateway: igw }
+ * });
+ *
+ * @example
+ * // Multi-account deployment with scope-level and resource-level overrides
+ * await alchemy.run("production", {
+ *   aws: { region: "us-west-2", profile: "main-account" }
+ * }, async () => {
+ *   // This Internet Gateway Attachment uses scope credentials (main-account, us-west-2)
+ *   const mainAttachment = await InternetGatewayAttachment("main-attachment", {
+ *     internetGateway: mainIgw,
+ *     vpc: mainVpc
+ *   });
+ *
+ *   // This Internet Gateway Attachment overrides to use different account
+ *   const crossAccountAttachment = await InternetGatewayAttachment("cross-account-attachment", {
+ *     internetGateway: crossIgw,
+ *     vpc: crossVpc,
+ *     profile: "secondary-account",
+ *     region: "us-east-1", // Also override region
+ *   });
  * });
  */
 export declare const InternetGatewayAttachment: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<InternetGatewayAttachment>, _id: string, props: InternetGatewayAttachmentProps) => Promise<InternetGatewayAttachment>);

package/lib/aws/ec2/internet-gateway-attachment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internet-gateway-attachment.d.ts","sourceRoot":"","sources":["../../../src/aws/ec2/internet-gateway-attachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,eAAe,EAAE,eAAe,GAAG,MAAM,CAAC;IAE1C;;OAEG;IACH,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,yBACf,SAAQ,QAAQ,CAAC,gCAAgC,CAAC,EAChD,8BAA8B;IAChC;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,eAAO,MAAM,yBAAyB,yFAG5B,OAAO,CAAC,yBAAyB,CAAC,OACnC,MAAM,SACJ,8BAA8B,KACpC,OAAO,CAAC,yBAAyB,CAAC,CA+KtC,CAAC;AAEF;;GAEG;AACH,KAAK,eAAe,GAChB,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,CAAC;AAEhB;;GAEG;AACH,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,UAAU,wBAAwB;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,gBAAgB,EAAE,wBAAwB,EAAE,CAAC;CAC9C;AAgCD;;GAEG;AACH,eAAO,MAAM,mCAAmC,EAAE,aAGjD,CAAC"}
+{"version":3,"file":"internet-gateway-attachment.d.ts","sourceRoot":"","sources":["../../../src/aws/ec2/internet-gateway-attachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,cAAc;IACpE;;OAEG;IACH,eAAe,EAAE,eAAe,GAAG,MAAM,CAAC;IAE1C;;OAEG;IACH,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,yBACf,SAAQ,QAAQ,CAAC,gCAAgC,CAAC,EAChD,8BAA8B;IAChC;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyHG;AACH,eAAO,MAAM,yBAAyB,yFAG5B,OAAO,CAAC,yBAAyB,CAAC,OACnC,MAAM,SACJ,8BAA8B,KACpC,OAAO,CAAC,yBAAyB,CAAC,CAgLtC,CAAC;AAEF;;GAEG;AACH,KAAK,eAAe,GAChB,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,CAAC;AAEhB;;GAEG;AACH,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,UAAU,wBAAwB;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,gBAAgB,EAAE,wBAAwB,EAAE,CAAC;CAC9C;AAgCD;;GAEG;AACH,eAAO,MAAM,mCAAmC,EAAE,aAGjD,CAAC"}

package/lib/aws/ec2/internet-gateway-attachment.js

@@ -16,6 +16,9 @@ import { callEC2Api, createEC2Client } from "./utils.js";
  * allowing traffic to flow between the VPC and the internet when combined with proper
  * routing configuration.
  *
+ * Supports AWS credential overrides at the resource level, allowing you to deploy Internet Gateway Attachments
+ * to different AWS accounts or regions than the default scope configuration.
+ *
  * @example
  * // Basic Internet Gateway attachment for internet connectivity
  * const vpc = await Vpc("main-vpc", {
@@ -30,6 +33,36 @@ import { callEC2Api, createEC2Client } from "./utils.js";
  * });
  *
  * @example
+ * // Internet Gateway Attachment with AWS credential overrides
+ * const crossAccountAttachment = await InternetGatewayAttachment("cross-account-attachment", {
+ *   internetGateway: igw,
+ *   vpc: vpc,
+ *   // Override AWS credentials for this specific resource
+ *   region: "us-east-1",
+ *   profile: "production-account",
+ * });
+ *
+ * @example
+ * // Internet Gateway Attachment in different region with role assumption
+ * const multiRegionAttachment = await InternetGatewayAttachment("multi-region-attachment", {
+ *   internetGateway: euIgw,
+ *   vpc: euVpc,
+ *   region: "eu-west-1",
+ *   roleArn: "arn:aws:iam::123456789012:role/CrossRegionRole",
+ *   roleSessionName: "igw-attachment-deployment",
+ * });
+ *
+ * @example
+ * // Internet Gateway Attachment with explicit credentials
+ * const explicitCredsAttachment = await InternetGatewayAttachment("explicit-creds-attachment", {
+ *   internetGateway: testIgw,
+ *   vpc: testVpc,
+ *   accessKeyId: alchemy.secret("AKIAIOSFODNN7EXAMPLE"),
+ *   secretAccessKey: alchemy.secret("wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"),
+ *   region: "us-west-2",
+ * });
+ *
+ * @example
  * // Internet Gateway attachment with custom timeout configuration
  * // for environments with slower AWS API responses
  * const attachment = await InternetGatewayAttachment("slow-env-attachment", {
@@ -58,7 +91,7 @@ import { callEC2Api, createEC2Client } from "./utils.js";
  *
  * // Create public subnet and route table for internet access
  * const publicSubnet = await Subnet("public-subnet", {
- *   vpc,
+ *   vpc: vpc,
  *   cidrBlock: "10.0.1.0/24",
  *   availabilityZone: "us-east-1a"
  * });
@@ -70,11 +103,32 @@ import { callEC2Api, createEC2Client } from "./utils.js";
  * const internetRoute = await Route("internet-route", {
  *   routeTable: publicRouteTable,
  *   destinationCidrBlock: "0.0.0.0/0",
- *   gateway: igw
+ *   target: { internetGateway: igw }
+ * });
+ *
+ * @example
+ * // Multi-account deployment with scope-level and resource-level overrides
+ * await alchemy.run("production", {
+ *   aws: { region: "us-west-2", profile: "main-account" }
+ * }, async () => {
+ *   // This Internet Gateway Attachment uses scope credentials (main-account, us-west-2)
+ *   const mainAttachment = await InternetGatewayAttachment("main-attachment", {
+ *     internetGateway: mainIgw,
+ *     vpc: mainVpc
+ *   });
+ *
+ *   // This Internet Gateway Attachment overrides to use different account
+ *   const crossAccountAttachment = await InternetGatewayAttachment("cross-account-attachment", {
+ *     internetGateway: crossIgw,
+ *     vpc: crossVpc,
+ *     profile: "secondary-account",
+ *     region: "us-east-1", // Also override region
+ *   });
  * });
  */
 export const InternetGatewayAttachment = Resource("aws::InternetGatewayAttachment", async function (_id, props) {
-    const client = await createEC2Client();
+    // Create EC2 client with credential resolution handled internally
+    const client = await createEC2Client(props);
     const timeoutConfig = mergeTimeoutConfig(INTERNET_GATEWAY_ATTACHMENT_TIMEOUT, props.timeout);
     const internetGatewayId = typeof props.internetGateway === "string"
         ? props.internetGateway

package/lib/aws/ec2/internet-gateway-attachment.js.map

@@ -1 +1 @@
-{"version":3,"file":"internet-gateway-attachment.js","sourceRoot":"","sources":["../../../src/aws/ec2/internet-gateway-attachment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"internet-gateway-attachment.js","sourceRoot":"","sources":["../../../src/aws/ec2/internet-gateway-attachment.ts"],"names":[],"mappings":"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"}

package/lib/aws/ec2/internet-gateway.d.ts

@@ -1,10 +1,11 @@
 import type { Context } from "../../context.ts";
 import { Resource } from "../../resource.ts";
 import { type TimeoutConfig } from "../../util/timeout.ts";
+import type { AwsClientProps } from "../client-props.ts";
 /**
  * Properties for creating or updating an Internet Gateway
  */
-export interface InternetGatewayProps {
+export interface InternetGatewayProps extends AwsClientProps {
     /**
      * Tags to apply to the Internet Gateway
      */
@@ -47,12 +48,15 @@ export interface InternetGateway extends Resource<"aws::InternetGateway">, Inter
  * 1. Provide a target in your VPC route tables for internet-routable traffic
  * 2. Perform network address translation (NAT) for instances with public IPv4 addresses
  *
+ * Supports AWS credential overrides at the resource level, allowing you to deploy Internet Gateways
+ * to different AWS accounts or regions than the default scope configuration.
+ *
  * @example
  * ```typescript
  * // Create a basic Internet Gateway
- * const igw = new InternetGateway({
+ * const igw = await InternetGateway("main-igw", {
  *   tags: {
- *     Name: "my-internet-gateway",
+ *     Name: "main-internet-gateway",
  *     Environment: "production"
  *   }
  * });
@@ -60,59 +64,49 @@ export interface InternetGateway extends Resource<"aws::InternetGateway">, Inter
  *
  * @example
  * ```typescript
- * // Create Internet Gateway with custom timeout configuration
- * const igw = new InternetGateway({
- *   tags: { Name: "custom-igw" },
- *   timeoutConfig: {
- *     maxAttempts: 30,
- *     delayMs: 1000
+ * // Create Internet Gateway with AWS credential overrides
+ * const crossAccountIgw = await InternetGateway("cross-account-igw", {
+ *   // Override AWS credentials for this specific resource
+ *   region: "us-east-1",
+ *   profile: "production-account",
+ *   tags: {
+ *     Name: "cross-account-internet-gateway",
+ *     Environment: "production"
  *   }
  * });
  * ```
  *
  * @example
  * ```typescript
- * // Create Internet Gateway and attach to VPC
- * const vpc = new VPC({ cidrBlock: "10.0.0.0/16" });
- * const igw = new InternetGateway({ tags: { Name: "vpc-igw" } });
- * const attachment = new InternetGatewayAttachment({
- *   internetGatewayId: igw.internetGatewayId,
- *   vpcId: vpc.vpcId
- * });
- * ```
- *
- * @example
- * ```typescript
- * // Access Internet Gateway properties
- * const igw = new InternetGateway({ tags: { Name: "example-igw" } });
- * logger.log(`Internet Gateway ID: ${igw.internetGatewayId}`);
- * logger.log(`State: ${igw.state}`);
- * ```
- *
- * Creates and manages Internet Gateways that provide internet access to VPCs.
- * Note: Use InternetGatewayAttachment to attach the gateway to a VPC.
- *
- * @example
- * // Create a basic Internet Gateway
- * const igw = await InternetGateway("main-igw", {
+ * // Create Internet Gateway in different region with role assumption
+ * const multiRegionIgw = await InternetGateway("multi-region-igw", {
+ *   region: "eu-west-1",
+ *   roleArn: "arn:aws:iam::123456789012:role/CrossRegionRole",
+ *   roleSessionName: "internet-gateway-deployment",
  *   tags: {
- *     Name: "main-internet-gateway",
- *     Environment: "production"
+ *     Name: "eu-internet-gateway",
+ *     Region: "europe"
  *   }
  * });
+ * ```
  *
  * @example
- * // Create an Internet Gateway for development environment
- * const devIgw = await InternetGateway("dev-igw", {
+ * ```typescript
+ * // Create Internet Gateway with explicit credentials
+ * const explicitCredsIgw = await InternetGateway("explicit-creds-igw", {
+ *   accessKeyId: alchemy.secret("AKIAIOSFODNN7EXAMPLE"),
+ *   secretAccessKey: alchemy.secret("wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"),
+ *   region: "us-west-2",
  *   tags: {
- *     Name: "dev-internet-gateway",
- *     Environment: "development",
- *     Team: "backend"
+ *     Name: "explicit-credentials-igw",
+ *     Purpose: "testing"
  *   }
  * });
+ * ```
  *
  * @example
- * // Create an Internet Gateway with custom timeout configuration
+ * ```typescript
+ * // Create Internet Gateway with custom timeout configuration
  * const customIgw = await InternetGateway("custom-igw", {
  *   timeout: {
  *     maxAttempts: 90,
@@ -123,6 +117,40 @@ export interface InternetGateway extends Resource<"aws::InternetGateway">, Inter
  *     Purpose: "high-availability"
  *   }
  * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create Internet Gateway and attach to VPC
+ * const vpc = await VPC("main-vpc", { cidrBlock: "10.0.0.0/16" });
+ * const igw = await InternetGateway("vpc-igw", {
+ *   tags: { Name: "vpc-internet-gateway" }
+ * });
+ * const attachment = await InternetGatewayAttachment("igw-attachment", {
+ *   internetGatewayId: igw.internetGatewayId,
+ *   vpcId: vpc.vpcId
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Multi-account deployment with scope-level and resource-level overrides
+ * await alchemy.run("production", {
+ *   aws: { region: "us-west-2", profile: "main-account" }
+ * }, async () => {
+ *   // This IGW uses scope credentials (main-account, us-west-2)
+ *   const mainIgw = await InternetGateway("main-igw", {
+ *     tags: { Name: "main-account-igw" }
+ *   });
+ *
+ *   // This IGW overrides to use different account
+ *   const crossAccountIgw = await InternetGateway("cross-account-igw", {
+ *     profile: "secondary-account",
+ *     region: "us-east-1", // Also override region
+ *     tags: { Name: "secondary-account-igw" }
+ *   });
+ * });
+ * ```
  */
 export declare const InternetGateway: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<InternetGateway>, _id: string, props: InternetGatewayProps) => Promise<InternetGateway>);
 /**

package/lib/aws/ec2/internet-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internet-gateway.d.ts","sourceRoot":"","sources":["../../../src/aws/ec2/internet-gateway.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAG/B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eACf,SAAQ,QAAQ,CAAC,sBAAsB,CAAC,EACtC,oBAAoB;IACtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;KAC5D,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,eAAO,MAAM,eAAe,yFAGlB,OAAO,CAAC,eAAe,CAAC,OACzB,MAAM,SACJ,oBAAoB,KAC1B,OAAO,CAAC,eAAe,CAAC,CAgH5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAGtC,CAAC"}
+{"version":3,"file":"internet-gateway.d.ts","sourceRoot":"","sources":["../../../src/aws/ec2/internet-gateway.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eACf,SAAQ,QAAQ,CAAC,sBAAsB,CAAC,EACtC,oBAAoB;IACtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;KAC5D,CAAC,CAAC;IAEH;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+GG;AACH,eAAO,MAAM,eAAe,yFAGlB,OAAO,CAAC,eAAe,CAAC,OACzB,MAAM,SACJ,oBAAoB,KAC1B,OAAO,CAAC,eAAe,CAAC,CAiH5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAGtC,CAAC"}