alchemy 0.54.0 → 0.55.0

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

@@ -0,0 +1,311 @@
+import { XMLParser } from "fast-xml-parser";
+import { Resource } from "../../resource.js";
+import { ignore } from "../../util/ignore.js";
+import { logger } from "../../util/logger.js";
+import { mergeTimeoutConfig, waitForResourceState, } from "../../util/timeout.js";
+import { callEC2Api, createEC2Client } from "./utils.js";
+/**
+ * Wait for Internet Gateway to be in available state
+ */
+async function waitForInternetGatewayAvailable(client, internetGatewayId, timeoutConfig) {
+    const checkFunction = async () => {
+        const response = await callEC2Api(client, "DescribeInternetGateways", parseInternetGatewayXmlResponse, {
+            "InternetGatewayId.1": internetGatewayId,
+        });
+        return response.InternetGateways?.[0];
+    };
+    const isReady = (igw) => {
+        return igw?.State === "available" || igw !== undefined; // IGWs are usually immediately available
+    };
+    await waitForResourceState(checkFunction, isReady, timeoutConfig, internetGatewayId, "Internet Gateway", "is now available");
+}
+/**
+ * Wait for Internet Gateway to be deleted
+ */
+async function waitForInternetGatewayDeleted(client, internetGatewayId, timeoutConfig) {
+    const checkFunction = async () => {
+        try {
+            const response = await callEC2Api(client, "DescribeInternetGateways", parseInternetGatewayXmlResponse, {
+                "InternetGatewayId.1": internetGatewayId,
+            });
+            return response.InternetGateways?.[0];
+        }
+        catch (error) {
+            // If Internet Gateway is not found, it's been deleted - return undefined
+            if (error.code === "InvalidInternetGatewayID.NotFound" ||
+                error.code === "InvalidInternetGateway.NotFound") {
+                return undefined;
+            }
+            throw error;
+        }
+    };
+    const isReady = (igw) => {
+        // Internet Gateway is deleted if it doesn't exist
+        return !igw;
+    };
+    await waitForResourceState(checkFunction, isReady, timeoutConfig, internetGatewayId, "Internet Gateway", "deletion completed");
+}
+/**
+ * AWS Internet Gateway Resource
+ *
+ * An Internet Gateway is a horizontally scaled, redundant, and highly available VPC component
+ * that allows communication between your VPC and the internet. It serves two purposes:
+ * 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
+ *
+ * @example
+ * ```typescript
+ * // Create a basic Internet Gateway
+ * const igw = new InternetGateway({
+ *   tags: {
+ *     Name: "my-internet-gateway",
+ *     Environment: "production"
+ *   }
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Create Internet Gateway with custom timeout configuration
+ * const igw = new InternetGateway({
+ *   tags: { Name: "custom-igw" },
+ *   timeoutConfig: {
+ *     maxAttempts: 30,
+ *     delayMs: 1000
+ *   }
+ * });
+ * ```
+ *
+ * @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", {
+ *   tags: {
+ *     Name: "main-internet-gateway",
+ *     Environment: "production"
+ *   }
+ * });
+ *
+ * @example
+ * // Create an Internet Gateway for development environment
+ * const devIgw = await InternetGateway("dev-igw", {
+ *   tags: {
+ *     Name: "dev-internet-gateway",
+ *     Environment: "development",
+ *     Team: "backend"
+ *   }
+ * });
+ *
+ * @example
+ * // Create an Internet Gateway with custom timeout configuration
+ * const customIgw = await InternetGateway("custom-igw", {
+ *   timeout: {
+ *     maxAttempts: 90,
+ *     delayMs: 1500
+ *   },
+ *   tags: {
+ *     Name: "custom-timeout-igw",
+ *     Purpose: "high-availability"
+ *   }
+ * });
+ */
+export const InternetGateway = Resource("aws::InternetGateway", async function (_id, props) {
+    const client = await createEC2Client();
+    const timeoutConfig = mergeTimeoutConfig(INTERNET_GATEWAY_TIMEOUT, props.timeout);
+    if (this.phase === "delete") {
+        if (this.output?.internetGatewayId) {
+            logger.log(`🗑️ Deleting Internet Gateway: ${this.output.internetGatewayId}`);
+            // Simply delete the Internet Gateway - attachments should handle themselves
+            await ignore("InvalidInternetGatewayID.NotFound", async () => {
+                await callEC2Api(client, "DeleteInternetGateway", parseInternetGatewayXmlResponse, {
+                    InternetGatewayId: this.output.internetGatewayId,
+                });
+            });
+            // Wait for Internet Gateway to be fully deleted
+            await waitForInternetGatewayDeleted(client, this.output.internetGatewayId, timeoutConfig);
+            logger.log(`  ✅ Internet Gateway ${this.output.internetGatewayId} deletion completed`);
+        }
+        return this.destroy();
+    }
+    let internetGateway;
+    if (this.phase === "update" && this.output?.internetGatewayId) {
+        // Get existing Internet Gateway
+        const response = await callEC2Api(client, "DescribeInternetGateways", parseInternetGatewayXmlResponse, {
+            "InternetGatewayId.1": this.output.internetGatewayId,
+        });
+        if (!response.InternetGateways?.[0]) {
+            throw new Error(`Internet Gateway ${this.output.internetGatewayId} not found`);
+        }
+        internetGateway = response.InternetGateways[0];
+    }
+    else {
+        // Create new Internet Gateway
+        const createInternetGatewayParams = {};
+        // Add tags if provided
+        if (props.tags) {
+            createInternetGatewayParams.TagSpecifications = [
+                {
+                    ResourceType: "internet-gateway",
+                    Tags: Object.entries(props.tags).map(([key, value]) => ({
+                        Key: key,
+                        Value: value,
+                    })),
+                },
+            ];
+        }
+        const createParams = convertCreateInternetGatewayParamsToAwsFormat(createInternetGatewayParams);
+        const response = await callEC2Api(client, "CreateInternetGateway", parseInternetGatewayXmlResponse, createParams);
+        if (!response.InternetGateway) {
+            throw new Error("Failed to create Internet Gateway");
+        }
+        internetGateway = response.InternetGateway;
+        // Wait for Internet Gateway to be available
+        await waitForInternetGatewayAvailable(client, internetGateway.InternetGatewayId, timeoutConfig);
+    }
+    return this({
+        internetGatewayId: internetGateway.InternetGatewayId,
+        state: "available",
+        attachments: internetGateway.Attachments?.map((att) => ({
+            vpcId: att.VpcId,
+            state: att.State,
+        })),
+        ownerId: internetGateway.OwnerId,
+        ...props,
+    });
+});
+/**
+ * Internet Gateway timeout constants
+ */
+export const INTERNET_GATEWAY_TIMEOUT = {
+    maxAttempts: 60,
+    delayMs: 2000, // 2 seconds - IGWs are medium speed resources
+};
+/**
+ * Helper functions to convert typed parameters to AWS API format
+ */
+function convertCreateInternetGatewayParamsToAwsFormat(params) {
+    const awsParams = {};
+    if (params.DryRun !== undefined) {
+        awsParams.DryRun = params.DryRun.toString();
+    }
+    // Handle TagSpecifications
+    if (params.TagSpecifications) {
+        params.TagSpecifications.forEach((tagSpec, specIndex) => {
+            const specNum = specIndex + 1;
+            awsParams[`TagSpecification.${specNum}.ResourceType`] =
+                tagSpec.ResourceType;
+            tagSpec.Tags.forEach((tag, tagIndex) => {
+                const tagNum = tagIndex + 1;
+                awsParams[`TagSpecification.${specNum}.Tag.${tagNum}.Key`] = tag.Key;
+                awsParams[`TagSpecification.${specNum}.Tag.${tagNum}.Value`] =
+                    tag.Value;
+            });
+        });
+    }
+    return awsParams;
+}
+/**
+ * Parse XML responses specifically for Internet Gateway operations
+ */
+function parseInternetGatewayXmlResponse(xmlText) {
+    const parser = new XMLParser({
+        ignoreAttributes: true,
+        parseAttributeValue: true,
+        parseTagValue: true,
+        trimValues: true,
+    });
+    const parsed = parser.parse(xmlText);
+    const result = {};
+    // Parse CreateInternetGatewayResponse
+    if (parsed.CreateInternetGatewayResponse) {
+        const internetGateway = parsed.CreateInternetGatewayResponse
+            .internetGateway;
+        if (internetGateway) {
+            result.InternetGateway = {
+                InternetGatewayId: internetGateway.internetGatewayId,
+                State: "available", // Internet Gateways are immediately available
+                Attachments: internetGateway.attachmentSet?.item
+                    ? (Array.isArray(internetGateway.attachmentSet.item)
+                        ? internetGateway.attachmentSet.item
+                        : [internetGateway.attachmentSet.item]).map((attachment) => ({
+                        VpcId: attachment.vpcId,
+                        State: attachment.state,
+                    }))
+                    : [],
+                Tags: internetGateway.tagSet?.item
+                    ? Array.isArray(internetGateway.tagSet.item)
+                        ? internetGateway.tagSet.item.map((tag) => ({
+                            Key: tag.key,
+                            Value: tag.value,
+                        }))
+                        : [
+                            {
+                                Key: internetGateway.tagSet.item.key,
+                                Value: internetGateway.tagSet.item.value,
+                            },
+                        ]
+                    : undefined,
+                OwnerId: internetGateway.ownerId,
+            };
+        }
+    }
+    // Parse DescribeInternetGatewaysResponse
+    if (parsed.DescribeInternetGatewaysResponse) {
+        const internetGatewaySet = parsed.DescribeInternetGatewaysResponse.internetGatewaySet;
+        if (internetGatewaySet?.item) {
+            const igws = Array.isArray(internetGatewaySet.item)
+                ? internetGatewaySet.item
+                : [internetGatewaySet.item];
+            result.InternetGateways = igws.map((igw) => ({
+                InternetGatewayId: igw.internetGatewayId,
+                State: "available",
+                Attachments: igw.attachmentSet?.item
+                    ? (Array.isArray(igw.attachmentSet.item)
+                        ? igw.attachmentSet.item
+                        : [igw.attachmentSet.item]).map((attachment) => ({
+                        VpcId: attachment.vpcId,
+                        State: attachment.state,
+                    }))
+                    : [],
+                Tags: igw.tagSet?.item
+                    ? Array.isArray(igw.tagSet.item)
+                        ? igw.tagSet.item.map((tag) => ({ Key: tag.key, Value: tag.value }))
+                        : [{ Key: igw.tagSet.item.key, Value: igw.tagSet.item.value }]
+                    : undefined,
+                OwnerId: igw.ownerId,
+            }));
+        }
+        else {
+            result.InternetGateways = [];
+        }
+    }
+    // Handle success responses
+    if (parsed.AttachInternetGatewayResponse ||
+        parsed.DetachInternetGatewayResponse ||
+        parsed.DeleteInternetGatewayResponse) {
+        result.success = true;
+    }
+    return result;
+}
+//# sourceMappingURL=internet-gateway.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,145 @@
+import type { Context } from "../../context.ts";
+import { Resource } from "../../resource.ts";
+import { type TimeoutConfig } from "../../util/timeout.ts";
+import type { Subnet } from "./subnet.ts";
+/**
+ * Properties for creating or updating a NAT Gateway
+ */
+export interface NatGatewayProps {
+    /**
+     * The subnet to create the NAT Gateway in (must be a public subnet)
+     */
+    subnet: Subnet | string;
+    /**
+     * The allocation ID of an existing Elastic IP address
+     * If not provided, a new Elastic IP will be allocated
+     */
+    allocationId?: string;
+    /**
+     * The connectivity type for the NAT Gateway
+     * @default "public"
+     */
+    connectivityType?: "public" | "private";
+    /**
+     * Tags to apply to the NAT Gateway
+     */
+    tags?: Record<string, string>;
+    /**
+     * Timeout configuration for NAT Gateway operations
+     * @default NAT Gateway-specific sensible defaults (60 attempts, 5000ms delay)
+     */
+    timeout?: Partial<TimeoutConfig>;
+}
+/**
+ * Output returned after NAT Gateway creation/update
+ */
+export interface NatGateway extends Resource<"aws::NatGateway">, NatGatewayProps {
+    /**
+     * The ID of the NAT Gateway
+     */
+    natGatewayId: string;
+    /**
+     * The ID of the subnet the NAT Gateway is in
+     */
+    subnetId: string;
+    /**
+     * The ID of the VPC the NAT Gateway belongs to
+     */
+    vpcId: string;
+    /**
+     * The current state of the NAT Gateway
+     */
+    state: "pending" | "failed" | "available" | "deleting" | "deleted";
+    /**
+     * The allocation ID of the Elastic IP address
+     */
+    allocationId: string;
+    /**
+     * The public IP address of the NAT Gateway
+     */
+    publicIp?: string;
+    /**
+     * The private IP address of the NAT Gateway
+     */
+    privateIp?: string;
+    /**
+     * Whether the Elastic IP was created by this resource
+     */
+    createdElasticIp: boolean;
+}
+/**
+ * AWS NAT Gateway Resource
+ *
+ * Creates and manages NAT Gateways that provide outbound internet access
+ * for instances in private subnets. Automatically allocates an Elastic IP
+ * if one is not provided. NAT Gateways are slow resources that can take
+ * up to 10 minutes to become available.
+ *
+ * @example
+ * // Create a NAT Gateway with automatic Elastic IP allocation
+ * const natGateway = await NatGateway("main-nat", {
+ * subnet: publicSubnet,
+ * tags: {
+ * Name: "main-nat-gateway",
+ * Environment: "production"
+ * }
+ * });
+ *
+ * @example
+ * // 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"
+ * }
+ * });
+ *
+ * @example
+ * // 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"
+ * }
+ * });
+ *
+ * @example
+ * // Create a NAT Gateway with custom timeout configuration
+ * const slowNat = await NatGateway("slow-nat", {
+ *   subnet: publicSubnet,
+ *   timeout: {
+ *     maxAttempts: 180, // Wait up to 15 minutes
+ *     delayMs: 5000     // Check every 5 seconds
+ *   },
+ *   tags: {
+ *     Name: "slow-nat-gateway"
+ *   }
+ * });
+ *
+ * @example
+ * // Use NAT Gateway in route table for private subnet internet access
+ * const privateRoute = await Route("private-internet", {
+ *   routeTable: privateRouteTable,
+ *   destinationCidrBlock: "0.0.0.0/0",
+ *   natGateway: natGateway,
+ *   tags: {
+ *     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>);
+/**
+ * Non-retryable error for NAT Gateway operations
+ */
+export declare class NatGatewayNonRetryableError extends Error {
+    constructor(message: string);
+}
+/**
+ * NAT Gateway timeout constants
+ */
+export declare const NAT_GATEWAY_TIMEOUT: TimeoutConfig;
+//# sourceMappingURL=nat-gateway.d.ts.map

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

@@ -0,0 +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"}