@joltdesign/scripts 0.19.3 → 0.21.0

package/README.md

@@ -1 +1,86 @@
 # jolt-scripts
+
+A TypeScript CLI tool that provides DevOps automation commands for WordPress/Docker development and AWS deployment workflows.
+
+## Configuration
+
+Jolt Scripts supports configuration through multiple sources (in order of precedence):
+1. `.jolt.json` (JSON format)
+2. `./bin/.env` (Environment variables)
+3. `.env` (Environment variables)
+
+### JSON Schema
+
+A JSON schema is automatically generated from the Zod schema at `jolt-config.schema.json` for IDE autocompletion and validation. The schema is regenerated automatically when building the project. You can reference it in your `.jolt.json` file:
+
+```json
+{
+  "$schema": "./node_modules/@joltdesign/scripts/jolt-config.schema.json",
+  "imageName": "my-app",
+  "awsRegion": "us-east-1",
+  "ecsCluster": "production-cluster"
+}
+```
+
+### Configuration Properties
+
+The configuration supports the following properties:
+
+#### AWS Configuration
+- `awsRegion`: AWS region for operations (default: "eu-west-1")
+- `ecsCluster`/`devEcsCluster`: ECS cluster names for production/development
+- `ecsService`/`devEcsService`: ECS service names for production/development
+- `codebuildProject`/`devCodebuildProject`: CodeBuild project names
+- `cloudfrontDistribution`: CloudFront distribution ID
+
+#### Docker Configuration
+- `imageName`: Docker image name for production builds
+- `devImageName`: Docker image name for development (overrides imageName + dev suffix)
+- `buildPlatform`: Docker build platform (e.g., "linux/amd64")
+- `buildContext`: Docker build context path (default: ".")
+- `ecrBaseUrl`: ECR repository base URL
+
+#### SSH & Deployment Configuration
+- `sshAccount`/`devSshAccount`: SSH accounts for deployments (user@host format)
+- `sshPort`: SSH port number (default: "22")
+- `liveFolder`/`devFolder`: Remote folder paths for deployments
+- `branch`/`devBranch`: Git branches for deployments
+- `repo`: Git repository URL
+
+#### Site-Specific Configuration
+Use the `sites` object to define site-specific overrides:
+
+```json
+{
+  "ecsCluster": "production-cluster",
+  "sites": {
+    "staging": {
+      "ecsCluster": "staging-cluster",
+      "ecsService": "my-app-staging"
+    }
+  }
+}
+```
+
+#### Command Overrides
+Override external tool commands:
+- `dockerCommand`, `composeCommand`, `terraformCommand`
+- `nodeCommand`, `yarnCommand`, `awsCommand`
+- `sshCommand`, `rsyncCommand`, `gitCommand`, `gzipCommand`
+
+#### Prepare Commands
+Define preparation commands to run before builds:
+
+```json
+{
+  "prepareCommands": [
+    "yarn install",
+    {
+      "cmd": "yarn build",
+      "name": "Build application",
+      "timing": "normal",
+      "fail": true
+    }
+  ]
+}
+```

package/dist/AWSClient.js

@@ -0,0 +1,102 @@
+import { CloudFrontClient } from '@aws-sdk/client-cloudfront';
+import { CloudWatchLogsClient } from '@aws-sdk/client-cloudwatch-logs';
+import { CodeBuildClient } from '@aws-sdk/client-codebuild';
+import { ECRClient } from '@aws-sdk/client-ecr';
+import { ECSClient } from '@aws-sdk/client-ecs';
+import { S3Client } from '@aws-sdk/client-s3';
+import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
+/**
+ * AWS SDK client manager for the Jolt Scripts CLI
+ * Provides configured clients for various AWS services
+ */
+export class AWSClientManager {
+    constructor(region) {
+        this.region = region;
+        this.clients = new Map();
+        this.credentialProvider = fromNodeProviderChain();
+    }
+    /**
+     * Get or create an ECS client
+     */
+    getECSClient() {
+        if (!this.clients.has('ecs')) {
+            this.clients.set('ecs', new ECSClient({
+                region: this.region,
+                credentials: this.credentialProvider,
+            }));
+        }
+        return this.clients.get('ecs');
+    }
+    /**
+     * Get or create an S3 client
+     */
+    getS3Client() {
+        if (!this.clients.has('s3')) {
+            this.clients.set('s3', new S3Client({
+                region: this.region,
+                credentials: this.credentialProvider,
+            }));
+        }
+        return this.clients.get('s3');
+    }
+    /**
+     * Get or create a CloudWatch Logs client
+     */
+    getCloudWatchLogsClient() {
+        if (!this.clients.has('logs')) {
+            this.clients.set('logs', new CloudWatchLogsClient({
+                region: this.region,
+                credentials: this.credentialProvider,
+            }));
+        }
+        return this.clients.get('logs');
+    }
+    /**
+     * Get or create a CodeBuild client
+     */
+    getCodeBuildClient() {
+        if (!this.clients.has('codebuild')) {
+            this.clients.set('codebuild', new CodeBuildClient({
+                region: this.region,
+                credentials: this.credentialProvider,
+            }));
+        }
+        return this.clients.get('codebuild');
+    }
+    /**
+     * Get or create a CloudFront client
+     */
+    getCloudFrontClient() {
+        if (!this.clients.has('cloudfront')) {
+            this.clients.set('cloudfront', new CloudFrontClient({
+                region: this.region,
+                credentials: this.credentialProvider,
+            }));
+        }
+        return this.clients.get('cloudfront');
+    }
+    /**
+     * Get or create an ECR client
+     */
+    getECRClient() {
+        if (!this.clients.has('ecr')) {
+            this.clients.set('ecr', new ECRClient({
+                region: this.region,
+                credentials: this.credentialProvider,
+            }));
+        }
+        return this.clients.get('ecr');
+    }
+    /**
+     * Clean up all clients
+     */
+    destroy() {
+        for (const client of this.clients.values()) {
+            if (client.destroy) {
+                client.destroy();
+            }
+        }
+        this.clients.clear();
+    }
+}
+//# sourceMappingURL=AWSClient.js.map

package/dist/AWSClient.js.map

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

package/dist/AWSConsoleUrlGenerator.js

@@ -0,0 +1,59 @@
+/**
+ * AWS Console URL Generator
+ *
+ * Utility for generating AWS console URLs for various services
+ */
+export const AWSConsoleUrlGenerator = {
+    /**
+     * Generate ECS service console URL
+     */
+    ecsService(region, cluster, service) {
+        return `https://${region}.console.aws.amazon.com/ecs/v2/clusters/${cluster}/services/${service}`;
+    },
+    /**
+     * Generate ECS cluster console URL
+     */
+    ecsCluster(region, cluster) {
+        return `https://${region}.console.aws.amazon.com/ecs/v2/clusters/${cluster}`;
+    },
+    /**
+     * Generate S3 bucket console URL
+     */
+    s3Bucket(_region, bucket) {
+        return `https://s3.console.aws.amazon.com/s3/buckets/${bucket}`;
+    },
+    /**
+     * Generate CloudWatch log group console URL
+     */
+    cloudWatchLogGroup(region, logGroup) {
+        const encodedLogGroup = encodeURIComponent(logGroup);
+        return `https://${region}.console.aws.amazon.com/cloudwatch/home?region=${region}#logsV2:log-groups/log-group/${encodedLogGroup}`;
+    },
+    /**
+     * Generate CodeBuild project console URL
+     */
+    codeBuildProject(region, projectName) {
+        return `https://${region}.console.aws.amazon.com/codesuite/codebuild/projects/${projectName}`;
+    },
+    /**
+     * Generate CodeBuild build console URL
+     */
+    codeBuildBuild(region, projectName, buildId) {
+        return `https://${region}.console.aws.amazon.com/codesuite/codebuild/projects/${projectName}/build/${buildId}`;
+    },
+    /**
+     * Generate CloudFront distribution console URL
+     */
+    cloudFrontDistribution(_region, distributionId) {
+        // CloudFront console is always in us-east-1 region but we include region for consistency
+        return `https://console.aws.amazon.com/cloudfront/v3/home#/distributions/${distributionId}`;
+    },
+    /**
+     * Extract bucket name from S3 URI
+     */
+    extractS3Bucket(s3Uri) {
+        const match = s3Uri.match(/^s3:\/\/([^/]+)/);
+        return match ? match[1] : null;
+    },
+};
+//# sourceMappingURL=AWSConsoleUrlGenerator.js.map

package/dist/AWSConsoleUrlGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AWSConsoleUrlGenerator.js","sourceRoot":"","sources":["../src/AWSConsoleUrlGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC;;OAEG;IACH,UAAU,CAAC,MAAc,EAAE,OAAe,EAAE,OAAe;QACzD,OAAO,WAAW,MAAM,2CAA2C,OAAO,aAAa,OAAO,EAAE,CAAA;IAClG,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,MAAc,EAAE,OAAe;QACxC,OAAO,WAAW,MAAM,2CAA2C,OAAO,EAAE,CAAA;IAC9E,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe,EAAE,MAAc;QACtC,OAAO,gDAAgD,MAAM,EAAE,CAAA;IACjE,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAc,EAAE,QAAgB;QACjD,MAAM,eAAe,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAA;QACpD,OAAO,WAAW,MAAM,kDAAkD,MAAM,gCAAgC,eAAe,EAAE,CAAA;IACnI,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAc,EAAE,WAAmB;QAClD,OAAO,WAAW,MAAM,wDAAwD,WAAW,EAAE,CAAA;IAC/F,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc,EAAE,WAAmB,EAAE,OAAe;QACjE,OAAO,WAAW,MAAM,wDAAwD,WAAW,UAAU,OAAO,EAAE,CAAA;IAChH,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,OAAe,EAAE,cAAsB;QAC5D,yFAAyF;QACzF,OAAO,oEAAoE,cAAc,EAAE,CAAA;IAC7F,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,KAAa;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAA;QAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAChC,CAAC;CACF,CAAA"}