alchemy 0.60.2 → 0.62.0

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

@@ -53,12 +53,15 @@ async function waitForInternetGatewayDeleted(client, internetGatewayId, timeoutC
  * 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"
  *   }
  * });
@@ -66,59 +69,49 @@ async function waitForInternetGatewayDeleted(client, internetGatewayId, timeoutC
  *
  * @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,
@@ -129,9 +122,44 @@ async function waitForInternetGatewayDeleted(client, internetGatewayId, timeoutC
  *     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 const InternetGateway = Resource("aws::InternetGateway", 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_TIMEOUT, props.timeout);
     if (this.phase === "delete") {
         if (this.output?.internetGatewayId) {

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

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

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

@@ -1,11 +1,12 @@
 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 { Subnet } from "./subnet.ts";
 /**
  * Properties for creating or updating a NAT Gateway
  */
-export interface NatGatewayProps {
+export interface NatGatewayProps extends AwsClientProps {
     /**
      * The subnet to create the NAT Gateway in (must be a public subnet)
      */
@@ -75,39 +76,94 @@ export interface NatGateway extends Resource<"aws::NatGateway">, NatGatewayProps
  * if one is not provided. NAT Gateways are slow resources that can take
  * up to 10 minutes to become available.
  *
+ * Supports AWS credential overrides at the resource level, allowing you to deploy NAT Gateways
+ * to different AWS accounts or regions than the default scope configuration.
+ *
  * @example
+ * ```typescript
  * // Create a NAT Gateway with automatic Elastic IP allocation
  * const natGateway = await NatGateway("main-nat", {
- * subnet: publicSubnet,
- * tags: {
- * Name: "main-nat-gateway",
- * Environment: "production"
- * }
+ *   subnet: publicSubnet,
+ *   tags: {
+ *     Name: "main-nat-gateway",
+ *     Environment: "production"
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create NAT Gateway with AWS credential overrides
+ * const crossAccountNat = await NatGateway("cross-account-nat", {
+ *   subnet: publicSubnet,
+ *   // Override AWS credentials for this specific resource
+ *   region: "us-east-1",
+ *   profile: "production-account",
+ *   tags: {
+ *     Name: "cross-account-nat-gateway",
+ *     Environment: "production"
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create NAT Gateway in different region with role assumption
+ * const multiRegionNat = await NatGateway("multi-region-nat", {
+ *   subnet: euPublicSubnet,
+ *   region: "eu-west-1",
+ *   roleArn: "arn:aws:iam::123456789012:role/CrossRegionRole",
+ *   roleSessionName: "nat-gateway-deployment",
+ *   tags: {
+ *     Name: "eu-nat-gateway",
+ *     Region: "europe"
+ *   }
  * });
+ * ```
  *
  * @example
+ * ```typescript
+ * // Create NAT Gateway with explicit credentials
+ * const explicitCredsNat = await NatGateway("explicit-creds-nat", {
+ *   subnet: testPublicSubnet,
+ *   accessKeyId: alchemy.secret("AKIAIOSFODNN7EXAMPLE"),
+ *   secretAccessKey: alchemy.secret("wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"),
+ *   region: "us-west-2",
+ *   tags: {
+ *     Name: "explicit-credentials-nat",
+ *     Purpose: "testing"
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
  * // Create a NAT Gateway with existing Elastic IP
  * const natGateway = await NatGateway("custom-nat", {
- * subnet: "subnet-12345678",
- * allocationId: "eipalloc-12345678",
- * connectivityType: "public",
- * tags: {
- * Name: "custom-nat-gateway"
- * }
+ *   subnet: "subnet-12345678",
+ *   allocationId: "eipalloc-12345678",
+ *   connectivityType: "public",
+ *   tags: {
+ *     Name: "custom-nat-gateway"
+ *   }
  * });
+ * ```
  *
  * @example
+ * ```typescript
  * // Create a private NAT Gateway (for VPC-to-VPC communication)
  * const privateNat = await NatGateway("private-nat", {
- * subnet: privateSubnet,
- * connectivityType: "private",
- * tags: {
- * Name: "private-nat-gateway",
- * Type: "internal"
- * }
+ *   subnet: privateSubnet,
+ *   connectivityType: "private",
+ *   tags: {
+ *     Name: "private-nat-gateway",
+ *     Type: "internal"
+ *   }
  * });
+ * ```
  *
  * @example
+ * ```typescript
  * // Create a NAT Gateway with custom timeout configuration
  * const slowNat = await NatGateway("slow-nat", {
  *   subnet: publicSubnet,
@@ -119,8 +175,32 @@ export interface NatGateway extends Resource<"aws::NatGateway">, NatGatewayProps
  *     Name: "slow-nat-gateway"
  *   }
  * });
+ * ```
+ *
+ * @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 NAT Gateway uses scope credentials (main-account, us-west-2)
+ *   const mainNat = await NatGateway("main-nat", {
+ *     subnet: mainPublicSubnet,
+ *     tags: { Name: "main-account-nat" }
+ *   });
+ *
+ *   // This NAT Gateway overrides to use different account
+ *   const crossAccountNat = await NatGateway("cross-account-nat", {
+ *     subnet: crossPublicSubnet,
+ *     profile: "secondary-account",
+ *     region: "us-east-1", // Also override region
+ *     tags: { Name: "secondary-account-nat" }
+ *   });
+ * });
+ * ```
  *
  * @example
+ * ```typescript
  * // Use NAT Gateway in route table for private subnet internet access
  * const privateRoute = await Route("private-internet", {
  *   routeTable: privateRouteTable,
@@ -130,6 +210,7 @@ export interface NatGateway extends Resource<"aws::NatGateway">, NatGatewayProps
  *     Name: "private-to-internet"
  *   }
  * });
+ * ```
  */
 export declare const NatGateway: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<NatGateway>, _id: string, props: NatGatewayProps) => Promise<NatGateway>);
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"nat-gateway.d.ts","sourceRoot":"","sources":["../../../src/aws/ec2/nat-gateway.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,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAExC;;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,UACf,SAAQ,QAAQ,CAAC,iBAAiB,CAAC,EACjC,eAAe;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAEnE;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,UAAU,yFAGb,OAAO,CAAC,UAAU,CAAC,OACpB,MAAM,SACJ,eAAe,KACrB,OAAO,CAAC,UAAU,CAAC,CA8LvB,CAAC;AAiOF;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAGjC,CAAC"}
+{"version":3,"file":"nat-gateway.d.ts","sourceRoot":"","sources":["../../../src/aws/ec2/nat-gateway.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,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAExC;;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,UACf,SAAQ,QAAQ,CAAC,iBAAiB,CAAC,EACjC,eAAe;IACjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAEnE;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+IG;AACH,eAAO,MAAM,UAAU,yFAGb,OAAO,CAAC,UAAU,CAAC,OACpB,MAAM,SACJ,eAAe,KACrB,OAAO,CAAC,UAAU,CAAC,CAmMvB,CAAC;AAqOF;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAGjC,CAAC"}

package/lib/aws/ec2/nat-gateway.js

@@ -12,39 +12,94 @@ import { callEC2Api, createEC2Client } from "./utils.js";
  * if one is not provided. NAT Gateways are slow resources that can take
  * up to 10 minutes to become available.
  *
+ * Supports AWS credential overrides at the resource level, allowing you to deploy NAT Gateways
+ * to different AWS accounts or regions than the default scope configuration.
+ *
  * @example
+ * ```typescript
  * // Create a NAT Gateway with automatic Elastic IP allocation
  * const natGateway = await NatGateway("main-nat", {
- * subnet: publicSubnet,
- * tags: {
- * Name: "main-nat-gateway",
- * Environment: "production"
- * }
+ *   subnet: publicSubnet,
+ *   tags: {
+ *     Name: "main-nat-gateway",
+ *     Environment: "production"
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create NAT Gateway with AWS credential overrides
+ * const crossAccountNat = await NatGateway("cross-account-nat", {
+ *   subnet: publicSubnet,
+ *   // Override AWS credentials for this specific resource
+ *   region: "us-east-1",
+ *   profile: "production-account",
+ *   tags: {
+ *     Name: "cross-account-nat-gateway",
+ *     Environment: "production"
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create NAT Gateway in different region with role assumption
+ * const multiRegionNat = await NatGateway("multi-region-nat", {
+ *   subnet: euPublicSubnet,
+ *   region: "eu-west-1",
+ *   roleArn: "arn:aws:iam::123456789012:role/CrossRegionRole",
+ *   roleSessionName: "nat-gateway-deployment",
+ *   tags: {
+ *     Name: "eu-nat-gateway",
+ *     Region: "europe"
+ *   }
  * });
+ * ```
  *
  * @example
+ * ```typescript
+ * // Create NAT Gateway with explicit credentials
+ * const explicitCredsNat = await NatGateway("explicit-creds-nat", {
+ *   subnet: testPublicSubnet,
+ *   accessKeyId: alchemy.secret("AKIAIOSFODNN7EXAMPLE"),
+ *   secretAccessKey: alchemy.secret("wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"),
+ *   region: "us-west-2",
+ *   tags: {
+ *     Name: "explicit-credentials-nat",
+ *     Purpose: "testing"
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
  * // Create a NAT Gateway with existing Elastic IP
  * const natGateway = await NatGateway("custom-nat", {
- * subnet: "subnet-12345678",
- * allocationId: "eipalloc-12345678",
- * connectivityType: "public",
- * tags: {
- * Name: "custom-nat-gateway"
- * }
+ *   subnet: "subnet-12345678",
+ *   allocationId: "eipalloc-12345678",
+ *   connectivityType: "public",
+ *   tags: {
+ *     Name: "custom-nat-gateway"
+ *   }
  * });
+ * ```
  *
  * @example
+ * ```typescript
  * // Create a private NAT Gateway (for VPC-to-VPC communication)
  * const privateNat = await NatGateway("private-nat", {
- * subnet: privateSubnet,
- * connectivityType: "private",
- * tags: {
- * Name: "private-nat-gateway",
- * Type: "internal"
- * }
+ *   subnet: privateSubnet,
+ *   connectivityType: "private",
+ *   tags: {
+ *     Name: "private-nat-gateway",
+ *     Type: "internal"
+ *   }
  * });
+ * ```
  *
  * @example
+ * ```typescript
  * // Create a NAT Gateway with custom timeout configuration
  * const slowNat = await NatGateway("slow-nat", {
  *   subnet: publicSubnet,
@@ -56,8 +111,32 @@ import { callEC2Api, createEC2Client } from "./utils.js";
  *     Name: "slow-nat-gateway"
  *   }
  * });
+ * ```
+ *
+ * @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 NAT Gateway uses scope credentials (main-account, us-west-2)
+ *   const mainNat = await NatGateway("main-nat", {
+ *     subnet: mainPublicSubnet,
+ *     tags: { Name: "main-account-nat" }
+ *   });
+ *
+ *   // This NAT Gateway overrides to use different account
+ *   const crossAccountNat = await NatGateway("cross-account-nat", {
+ *     subnet: crossPublicSubnet,
+ *     profile: "secondary-account",
+ *     region: "us-east-1", // Also override region
+ *     tags: { Name: "secondary-account-nat" }
+ *   });
+ * });
+ * ```
  *
  * @example
+ * ```typescript
  * // Use NAT Gateway in route table for private subnet internet access
  * const privateRoute = await Route("private-internet", {
  *   routeTable: privateRouteTable,
@@ -67,8 +146,11 @@ import { callEC2Api, createEC2Client } from "./utils.js";
  *     Name: "private-to-internet"
  *   }
  * });
+ * ```
  */
 export const NatGateway = Resource("aws::NatGateway", async function (_id, props) {
+    // Create EC2 client with credential resolution handled internally
+    const client = await createEC2Client(props);
     const subnetId = typeof props.subnet === "string" ? props.subnet : props.subnet.subnetId;
     const timeoutConfig = mergeTimeoutConfig(NAT_GATEWAY_TIMEOUT, props.timeout);
     if (this.phase === "delete") {
@@ -76,26 +158,24 @@ export const NatGateway = Resource("aws::NatGateway", async function (_id, props
             logger.log(`🗑️ Deleting NAT Gateway: ${this.output.natGatewayId}`);
             // Delete NAT Gateway if it exists
             await ignore("InvalidNatGatewayID.NotFound", async () => {
-                const client = await createEC2Client();
                 await callEC2Api(client, "DeleteNatGateway", parseNatGatewayXmlResponse, convertDeleteNatGatewayParamsToAwsFormat({
                     NatGatewayId: this.output.natGatewayId,
                 }));
             });
             // Wait for NAT Gateway to be deleted AND network interfaces to be cleaned up
             logger.log(`  Waiting for NAT Gateway ${this.output.natGatewayId} to be fully deleted...`);
-            await waitForNatGatewayFullyDeleted(this.output.natGatewayId, timeoutConfig);
+            await waitForNatGatewayFullyDeleted(this.output.natGatewayId, timeoutConfig, props);
             logger.log(`  ✅ NAT Gateway ${this.output.natGatewayId} deletion completed`);
             // Release Elastic IP if we created it and it exists
             if (this.output.createdElasticIp && this.output.allocationId) {
                 logger.log(`  Releasing Elastic IP: ${this.output.allocationId}`);
                 await ignore(["InvalidAllocationID.NotFound", "InvalidAddress.NotFound"], async () => {
-                    const eipClient = await createEC2Client();
-                    await callEC2Api(eipClient, "ReleaseAddress", parseNatGatewayXmlResponse, convertReleaseAddressParamsToAwsFormat({
+                    await callEC2Api(client, "ReleaseAddress", parseNatGatewayXmlResponse, convertReleaseAddressParamsToAwsFormat({
                         AllocationId: this.output.allocationId,
                     }));
                 });
                 // Wait for the EIP to be fully released
-                await waitForEipReleased(this.output.allocationId, timeoutConfig);
+                await waitForEipReleased(this.output.allocationId, timeoutConfig, props);
                 logger.log(`  ✅ Elastic IP ${this.output.allocationId} released successfully`);
             }
         }
@@ -107,7 +187,6 @@ export const NatGateway = Resource("aws::NatGateway", async function (_id, props
     let publicIp;
     if (this.phase === "update" && this.output?.natGatewayId) {
         // Get existing NAT Gateway
-        const client = await createEC2Client();
         const response = await callEC2Api(client, "DescribeNatGateways", parseNatGatewayXmlResponse, convertDescribeNatGatewaysParamsToAwsFormat({
             NatGatewayIds: [this.output.natGatewayId],
         }));
@@ -137,7 +216,6 @@ export const NatGateway = Resource("aws::NatGateway", async function (_id, props
                     },
                 ];
             }
-            const client = await createEC2Client();
             const eipResponse = await callEC2Api(client, "AllocateAddress", parseNatGatewayXmlResponse, convertAllocateAddressParamsToAwsFormat(eipParams));
             if (!eipResponse.AllocationId) {
                 throw new Error("Failed to allocate Elastic IP");
@@ -148,7 +226,6 @@ export const NatGateway = Resource("aws::NatGateway", async function (_id, props
         }
         else {
             // Get public IP of existing allocation
-            const client = await createEC2Client();
             const addressResponse = await callEC2Api(client, "DescribeAddresses", parseNatGatewayXmlResponse, convertDescribeAddressesParamsToAwsFormat({
                 AllocationIds: [allocationId],
             }));
@@ -172,14 +249,13 @@ export const NatGateway = Resource("aws::NatGateway", async function (_id, props
                 },
             ];
         }
-        const natClient = await createEC2Client();
-        const response = await callEC2Api(natClient, "CreateNatGateway", parseNatGatewayXmlResponse, convertCreateNatGatewayParamsToAwsFormat(createParams));
+        const response = await callEC2Api(client, "CreateNatGateway", parseNatGatewayXmlResponse, convertCreateNatGatewayParamsToAwsFormat(createParams));
         if (!response.NatGateway) {
             throw new Error("Failed to create NAT Gateway");
         }
         natGateway = response.NatGateway;
         // Wait for NAT Gateway to be available
-        await waitForNatGatewayAvailable(natGateway.NatGatewayId, timeoutConfig);
+        await waitForNatGatewayAvailable(natGateway.NatGatewayId, timeoutConfig, props);
     }
     const result = this({
         natGatewayId: natGateway.NatGatewayId,
@@ -198,9 +274,9 @@ export const NatGateway = Resource("aws::NatGateway", async function (_id, props
 /**
  * Wait for NAT Gateway to be in available state
  */
-async function waitForNatGatewayAvailable(natGatewayId, timeoutConfig) {
+async function waitForNatGatewayAvailable(natGatewayId, timeoutConfig, credentials) {
     const checkFunction = async () => {
-        const client = await createEC2Client();
+        const client = await createEC2Client(credentials);
         const response = await callEC2Api(client, "DescribeNatGateways", parseNatGatewayXmlResponse, convertDescribeNatGatewaysParamsToAwsFormat({
             NatGatewayIds: [natGatewayId],
         }));
@@ -218,10 +294,10 @@ async function waitForNatGatewayAvailable(natGatewayId, timeoutConfig) {
 /**
  * Wait for NAT Gateway to be deleted
  */
-async function waitForNatGatewayDeleted(natGatewayId, timeoutConfig) {
+async function waitForNatGatewayDeleted(natGatewayId, timeoutConfig, credentials) {
     const checkFunction = async () => {
         try {
-            const client = await createEC2Client();
+            const client = await createEC2Client(credentials);
             const response = await callEC2Api(client, "DescribeNatGateways", parseNatGatewayXmlResponse, convertDescribeNatGatewaysParamsToAwsFormat({
                 NatGatewayIds: [natGatewayId],
             }));
@@ -273,10 +349,10 @@ function parseDescribeNetworkInterfacesResponse(xmlText) {
 /**
  * Wait for an Elastic IP to be released.
  */
-async function waitForEipReleased(allocationId, timeoutConfig) {
+async function waitForEipReleased(allocationId, timeoutConfig, credentials) {
     const checkFunction = async () => {
         try {
-            const eipClient = await createEC2Client();
+            const eipClient = await createEC2Client(credentials);
             const addressResponse = await callEC2Api(eipClient, "DescribeAddresses", parseNatGatewayXmlResponse, convertDescribeAddressesParamsToAwsFormat({
                 AllocationIds: [allocationId],
             }));
@@ -298,13 +374,13 @@ async function waitForEipReleased(allocationId, timeoutConfig) {
 /**
  * Wait for NAT Gateway to be fully deleted including network interface cleanup
  */
-async function waitForNatGatewayFullyDeleted(natGatewayId, timeoutConfig) {
+async function waitForNatGatewayFullyDeleted(natGatewayId, timeoutConfig, credentials) {
     // First wait for the NAT Gateway itself to be deleted
-    await waitForNatGatewayDeleted(natGatewayId, timeoutConfig);
+    await waitForNatGatewayDeleted(natGatewayId, timeoutConfig, credentials);
     // Then wait for network interfaces to be cleaned up
     const checkNetworkInterfaces = async () => {
         try {
-            const client = await createEC2Client();
+            const client = await createEC2Client(credentials);
             const response = await callEC2Api(client, "DescribeNetworkInterfaces", parseDescribeNetworkInterfacesResponse, {
                 "Filter.1.Name": "description",
                 "Filter.1.Value.1": `Interface for NAT Gateway ${natGatewayId}`,