@ts-cloud/core 0.16.36 → 0.16.38

package/dist/modules/compute.d.ts

@@ -148,6 +148,25 @@ export interface ScalingPolicyOptions {
     scaleInCooldown?: number;
     scaleOutCooldown?: number;
 }
+/**
+ * Whether an EC2 instance type runs on Graviton (arm64): `a1`, and every
+ * family whose generation number is followed by `g` - t4g, m7g, c7gn, r8g,
+ * x2gd, im4gn, is4gen, g5g.
+ */
+export declare function isArmInstanceType(instanceType: string): boolean;
+/**
+ * AWS's public SSM parameter for the current Amazon Linux 2023 AMI of the
+ * instance type's architecture. AWS keeps one in every region.
+ */
+export declare function amazonLinuxImageParameter(instanceType?: string): string;
+/**
+ * An `ImageId` that CloudFormation resolves to that AMI in the stack's own
+ * region, as a `{{resolve:ssm:...}}` dynamic reference. A template parameter
+ * of type `AWS::SSM::Parameter::Value<AWS::EC2::Image::Id>` would do the same,
+ * but the module helpers return resources, not whole templates, so they have
+ * nowhere to declare one.
+ */
+export declare function amazonLinuxImageId(instanceType?: string): string;
 /**
  * Compute Module - EC2, ECS, Lambda Management
  * Provides clean API for both server (Forge-style) and serverless (Vapor-style) deployments
@@ -468,21 +487,36 @@ export declare class Compute {
         }>;
     };
     /**
-     * Create a JumpBox (Bastion Host) for SSH access to private resources
+     * Create a JumpBox (Bastion Host) for access to private resources.
+     *
+     * Shell access is SSM Session Manager (`aws ssm start-session`): the role
+     * carries AmazonSSMManagedInstanceCore and Amazon Linux 2023 ships the
+     * agent, so no key pair and no open port are needed. `keyName` adds SSH on
+     * top, and only then - or when `allowedCidrs` is given - is port 22 opened.
+     *
+     * The image is the region's current Amazon Linux 2023, resolved from AWS's
+     * public SSM parameter for the instance type's architecture. It used to be
+     * a us-east-1 AMI literal, which no other region has, and `keyName` was
+     * required, naming a key pair that had to exist before the deploy.
      */
     static createJumpBox(options: {
         slug: string;
         environment: EnvironmentType;
         vpcId: string;
         subnetId: string;
-        keyName: string;
+        keyName?: string;
         instanceType?: string;
         imageId?: string;
         allowedCidrs?: string[];
         mountEfs?: {
-            fileSystemId: string;
+            /** An EFS id, or a `{ Ref }` to a file system in the same template. */
+            fileSystemId: string | {
+                Ref: string;
+            };
             mountPath?: string;
         };
+        /** Install the PostgreSQL, MariaDB and Redis clients. */
+        databaseTools?: boolean;
     }): {
         instance: EC2Instance;
         securityGroup: EC2SecurityGroup;
@@ -506,42 +540,25 @@ export declare class Compute {
             environment: EnvironmentType;
             vpcId: string;
             subnetId: string;
-            keyName: string;
-            fileSystemId: string;
+            keyName?: string;
+            instanceType?: string;
+            fileSystemId: string | {
+                Ref: string;
+            };
             mountPath?: string;
             allowedCidrs?: string[];
-        }) => {
-            instance: EC2Instance;
-            securityGroup: EC2SecurityGroup;
-            instanceProfile: any;
-            instanceRole: IAMRole;
-            instanceLogicalId: string;
-            securityGroupLogicalId: string;
-            instanceProfileLogicalId: string;
-            instanceRoleLogicalId: string;
-            resources: Record<string, any>;
-        };
+        }) => ReturnType<typeof Compute.createJumpBox>;
         /**
-         * Create minimal JumpBox (SSH only)
+         * Create minimal JumpBox
          */
         minimal: (params: {
             slug: string;
             environment: EnvironmentType;
             vpcId: string;
             subnetId: string;
-            keyName: string;
+            keyName?: string;
             allowedCidrs?: string[];
-        }) => {
-            instance: EC2Instance;
-            securityGroup: EC2SecurityGroup;
-            instanceProfile: any;
-            instanceRole: IAMRole;
-            instanceLogicalId: string;
-            securityGroupLogicalId: string;
-            instanceProfileLogicalId: string;
-            instanceRoleLogicalId: string;
-            resources: Record<string, any>;
-        };
+        }) => ReturnType<typeof Compute.createJumpBox>;
         /**
          * Create JumpBox with database tools
          */
@@ -550,19 +567,10 @@ export declare class Compute {
             environment: EnvironmentType;
             vpcId: string;
             subnetId: string;
-            keyName: string;
+            keyName?: string;
+            instanceType?: string;
             allowedCidrs?: string[];
-        }) => {
-            instance: EC2Instance;
-            securityGroup: EC2SecurityGroup;
-            instanceProfile: any;
-            instanceRole: IAMRole;
-            instanceLogicalId: string;
-            securityGroupLogicalId: string;
-            instanceProfileLogicalId: string;
-            instanceRoleLogicalId: string;
-            resources: Record<string, any>;
-        };
+        }) => ReturnType<typeof Compute.createJumpBox>;
         /**
          * Allowed CIDRs for corporate VPNs (common patterns)
          */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ts-cloud/core",
   "type": "module",
-  "version": "0.16.36",
+  "version": "0.16.38",
   "description": "Core CloudFormation generation library for ts-cloud",
   "author": "Chris Breuer <chris@stacksjs.com>",
   "license": "MIT",
@@ -31,7 +31,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ts-cloud/aws-types": "0.16.36"
+    "@ts-cloud/aws-types": "0.16.38"
   },
   "devDependencies": {
     "typescript": "^7.0.2"