@joltdesign/scripts 0.19.3 → 0.21.0

package/dist/utils.js

@@ -1,6 +1,9 @@
 import { readFile, stat } from 'node:fs/promises';
+import ansis from 'ansis';
+import { camelCase, constantCase } from 'change-case';
 import { execa } from 'execa';
 import realWhich from 'which';
+import { ContainerRuntimeError } from './errors.js';
 export async function fileExists(path) {
     try {
         return (await stat(path)).isFile();
@@ -18,17 +21,90 @@ export async function directoryExists(path) {
     }
 }
 export function constToCamel(key) {
-    let parts = key.split('_');
-    parts = parts.map((x) => x.toLocaleLowerCase().replace(/^./, (y) => y.toLocaleUpperCase()));
-    parts[0] = parts[0].toLocaleLowerCase();
-    return parts.join('');
+    return camelCase(key);
 }
 export function keyToConst(str) {
-    var _a;
-    return (((_a = str
-        .match(/[A-Z]{2,}(?=[A-Z][a-z]+[0-9]*|\b)|[A-Z]?[a-z]+[0-9]*|[A-Z]|[0-9]+/g)) === null || _a === void 0 ? void 0 : _a.map((x) => x.toLowerCase()).join('_').toUpperCase()) || str);
+    return constantCase(str);
+}
+/**
+ * Detects if an error message indicates a container runtime daemon is not running
+ * Supports Docker, Podman, and Rancher Desktop
+ */
+function isContainerRuntimeError(errorMessage) {
+    const containerRuntimeErrorPatterns = [
+        // Docker patterns
+        /cannot connect to the docker daemon/i,
+        /docker: error during connect/i,
+        /is the docker daemon running/i,
+        /connection refused.*docker/i,
+        /docker desktop is not running/i,
+        /error during connect.*docker/i,
+        /failed to connect to.*docker/i,
+        /dial unix.*docker\.sock.*connection refused/i,
+        /connect: no such file or directory.*docker\.sock/i,
+        // Podman patterns
+        /cannot connect to podman/i,
+        /error: unable to connect to podman/i,
+        /is the podman service running/i,
+        /connection refused.*podman/i,
+        /podman desktop is not running/i,
+        /unable to connect to podman socket/i,
+        /dial unix.*podman\.sock.*connection refused/i,
+        /connect: no such file or directory.*podman\.sock/i,
+        // Rancher Desktop patterns (uses Docker API but with Rancher-specific paths)
+        /rancher desktop is not running/i,
+        /connection refused.*rancher/i,
+        /dial unix.*rancher.*docker\.sock.*connection refused/i,
+        /connect: no such file or directory.*rancher.*docker\.sock/i,
+        /dial unix.*\.rd\/.*connection refused/i,
+        /connect: no such file or directory.*\.rd\//i,
+    ];
+    return containerRuntimeErrorPatterns.some((pattern) => pattern.test(errorMessage));
+}
+/**
+ * Detects the container runtime type from the command and error message
+ */
+function detectContainerRuntime(command, errorMessage) {
+    if (command.includes('podman') || /podman/i.test(errorMessage)) {
+        return 'podman';
+    }
+    // Check for Rancher Desktop indicators in the error message
+    if (/rancher/i.test(errorMessage) || /\.rd\//i.test(errorMessage)) {
+        return 'rancher';
+    }
+    if (command.includes('docker') || /docker/i.test(errorMessage)) {
+        return 'docker';
+    }
+    return 'unknown';
+}
+/**
+ * Creates a user-friendly error message for container runtime issues
+ */
+function createContainerRuntimeErrorMessage(command, originalError) {
+    const runtime = detectContainerRuntime(command, originalError);
+    let runtimeName;
+    let suggestion;
+    switch (runtime) {
+        case 'podman':
+            runtimeName = 'Podman';
+            suggestion = 'Please start Podman Desktop or ensure the Podman service is running before retrying.';
+            break;
+        case 'rancher':
+            runtimeName = 'Rancher Desktop';
+            suggestion = 'Please start Rancher Desktop or ensure the container runtime is running before retrying.';
+            break;
+        default:
+            runtimeName = 'Docker';
+            suggestion = 'Please start Docker Desktop or ensure the Docker daemon is running before retrying.';
+            break;
+    }
+    const header = ansis.red(`🐳 ${runtimeName} daemon is not running!`);
+    const suggestionText = ansis.yellow(suggestion);
+    const details = ansis.gray(`Original error: ${originalError}`);
+    return `${header}\n${suggestionText}\n${details}`;
 }
 export async function execC(command, args = [], options = {}) {
+    var _a;
     const allOptions = {
         shell: true,
         cleanArgs: true,
@@ -43,7 +119,29 @@ export async function execC(command, args = [], options = {}) {
     if (allOptions.cleanArgs) {
         argsToUse = args.filter((x) => !!x);
     }
-    return await execa(command, argsToUse, allOptions);
+    try {
+        return await execa(command, argsToUse, allOptions);
+    }
+    catch (error) {
+        // Check if this is a container runtime command that failed due to daemon not running
+        if (error instanceof Error &&
+            'stderr' in error &&
+            typeof error.stderr === 'string' &&
+            (command.includes('docker') || command.includes('podman'))) {
+            const errorMessage = error.stderr || error.message || '';
+            if (isContainerRuntimeError(errorMessage)) {
+                const friendlyMessage = createContainerRuntimeErrorMessage(command, errorMessage);
+                // Write the friendly error to stderr if available
+                if ((_a = options.context) === null || _a === void 0 ? void 0 : _a.stderr) {
+                    options.context.stderr.write(`${friendlyMessage}\n`);
+                }
+                // Throw a specific ContainerRuntimeError for programmatic handling
+                throw new ContainerRuntimeError(friendlyMessage);
+            }
+        }
+        // Re-throw the original error if it's not a container runtime daemon issue
+        throw error;
+    }
 }
 export function delay(ms) {
     return new Promise((res) => setTimeout(res, ms, null));
@@ -59,13 +157,49 @@ asyncFn) {
     const data = await Promise.all(promises);
     return str.replace(replace, () => data.shift() || '');
 }
+// Cache for memoizing which() results since command availability doesn't change during execution
+const whichCache = new Map();
+/**
+ * Clear the which() cache - primarily for testing purposes
+ */
+export function clearWhichCache() {
+    whichCache.clear();
+}
 export async function which(cmd) {
+    var _a;
+    // Check cache first
+    if (whichCache.has(cmd)) {
+        return (_a = whichCache.get(cmd)) !== null && _a !== void 0 ? _a : null;
+    }
+    let result = null;
     const parts = cmd.split(' ');
     if (parts[1] === 'compose') {
-        // TODO: Check for compose extension?
-        return await which(parts[0]);
+        // First check if docker exists
+        const dockerPath = await which(parts[0]);
+        if (!dockerPath) {
+            result = null;
+        }
+        else {
+            // Then verify docker compose plugin is available
+            try {
+                await execa(parts[0], ['compose', 'version'], {
+                    stdio: 'ignore',
+                    timeout: 5000,
+                });
+                result = dockerPath;
+            }
+            catch (_b) {
+                // docker compose plugin not available
+                result = null;
+            }
+        }
+    }
+    else {
+        result = await realWhich(cmd, { nothrow: true });
     }
-    return await realWhich(cmd, { nothrow: true });
+    // Cache the result
+    whichCache.set(cmd, result);
+    return result;
 }
 export async function getPackageJson() {
     const contents = await readFile(`${import.meta.dirname}/../package.json`);

package/dist/utils.js.map

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

package/jolt-config.schema.json

@@ -0,0 +1,308 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "awsRegion": {
+      "default": "eu-west-1",
+      "description": "AWS region for operations",
+      "type": "string"
+    },
+    "imageName": {
+      "description": "Docker image name for production builds",
+      "type": "string"
+    },
+    "devImageName": {
+      "description": "Docker image name for development builds (overrides imageName + dev suffix)",
+      "type": "string"
+    },
+    "devSuffix": {
+      "default": "-dev",
+      "description": "Suffix to append to image name for development builds",
+      "type": "string"
+    },
+    "buildPlatform": {
+      "description": "Docker build platform (e.g., linux/amd64, linux/arm64)",
+      "type": "string"
+    },
+    "buildContext": {
+      "default": ".",
+      "description": "Docker build context path",
+      "type": "string"
+    },
+    "ecrBaseUrl": {
+      "description": "ECR repository base URL",
+      "type": "string"
+    },
+    "ecsCluster": {
+      "description": "Production ECS cluster name",
+      "type": "string"
+    },
+    "devEcsCluster": {
+      "description": "Development ECS cluster name",
+      "type": "string"
+    },
+    "ecsService": {
+      "description": "Production ECS service name",
+      "type": "string"
+    },
+    "devEcsService": {
+      "description": "Development ECS service name",
+      "type": "string"
+    },
+    "codebuildProject": {
+      "description": "Production CodeBuild project name",
+      "type": "string"
+    },
+    "devCodebuildProject": {
+      "description": "Development CodeBuild project name",
+      "type": "string"
+    },
+    "cloudfrontDistribution": {
+      "description": "CloudFront distribution ID for cache invalidation",
+      "type": "string"
+    },
+    "sshAccount": {
+      "description": "SSH account for production deployments (user@host format)",
+      "type": "string"
+    },
+    "devSshAccount": {
+      "description": "SSH account for development deployments (user@host format)",
+      "type": "string"
+    },
+    "sshPort": {
+      "default": "22",
+      "description": "SSH port number",
+      "type": "string"
+    },
+    "liveFolder": {
+      "description": "Remote folder path for production deployments",
+      "type": "string"
+    },
+    "devFolder": {
+      "description": "Remote folder path for development deployments",
+      "type": "string"
+    },
+    "branch": {
+      "description": "Git branch for production deployments",
+      "type": "string"
+    },
+    "devBranch": {
+      "description": "Git branch for development deployments",
+      "type": "string"
+    },
+    "repo": {
+      "description": "Git repository URL",
+      "type": "string"
+    },
+    "codeSubfolder": {
+      "description": "Subfolder within repository containing the code",
+      "type": "string"
+    },
+    "nexcessDeployScript": {
+      "default": "bin/nexcess-deploy-script.sh",
+      "description": "Path to Nexcess deployment script",
+      "type": "string"
+    },
+    "nexcessCleanupScript": {
+      "default": "bin/nexcess-cleanup.sh",
+      "description": "Path to Nexcess cleanup script",
+      "type": "string"
+    },
+    "dbSeed": {
+      "description": "Database seed file path",
+      "type": "string"
+    },
+    "dbBackupPath": {
+      "description": "Path for database backups",
+      "type": "string"
+    },
+    "devPlugins": {
+      "description": "WordPress plugins to activate in development",
+      "type": "string"
+    },
+    "devPluginDelay": {
+      "default": "30",
+      "description": "Delay in seconds before activating dev plugins",
+      "type": "string"
+    },
+    "wpCliContainer": {
+      "description": "Docker container name for WP-CLI operations",
+      "type": "string"
+    },
+    "wpCliContainerProfile": {
+      "description": "Docker Compose profile for WP-CLI container",
+      "type": "string"
+    },
+    "wpUpdates": {
+      "description": "WordPress automatic update configuration",
+      "type": "object",
+      "properties": {
+        "doNotUpdate": {
+          "description": "List of plugins/themes to skip during updates",
+          "default": [],
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "pluginFolder": {
+          "description": "Path to WordPress plugins folder",
+          "default": "code/wp-content/plugins",
+          "type": "string"
+        },
+        "themeFolder": {
+          "description": "Path to WordPress themes folder",
+          "default": "code/wp-content/themes",
+          "type": "string"
+        },
+        "wpRoot": {
+          "description": "Path to WordPress root directory",
+          "default": "code/",
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "dockerCommand": {
+      "default": "docker",
+      "description": "Override for docker command",
+      "type": "string"
+    },
+    "composeCommand": {
+      "default": "docker compose",
+      "description": "Override for docker compose command",
+      "type": "string"
+    },
+    "terraformCommand": {
+      "description": "Override for terraform/tofu command (auto-detects tofu vs terraform)",
+      "type": "string"
+    },
+    "nodeCommand": {
+      "default": "node",
+      "description": "Override for node command",
+      "type": "string"
+    },
+    "yarnCommand": {
+      "default": "yarn",
+      "description": "Override for yarn command",
+      "type": "string"
+    },
+    "awsCommand": {
+      "default": "aws",
+      "description": "Override for aws command",
+      "type": "string"
+    },
+    "sshCommand": {
+      "default": "ssh",
+      "description": "Override for ssh command",
+      "type": "string"
+    },
+    "rsyncCommand": {
+      "default": "rsync",
+      "description": "Override for rsync command",
+      "type": "string"
+    },
+    "gitCommand": {
+      "default": "git",
+      "description": "Override for git command",
+      "type": "string"
+    },
+    "gzipCommand": {
+      "default": "gzip",
+      "description": "Override for gzip command",
+      "type": "string"
+    },
+    "prepareCommands": {
+      "description": "Commands to run during preparation phase",
+      "type": "array",
+      "items": {
+        "anyOf": [
+          {
+            "description": "Simple command string",
+            "type": "string"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "cmd": {
+                "description": "Command to execute",
+                "type": "string"
+              },
+              "name": {
+                "description": "Display name for the command",
+                "type": "string"
+              },
+              "fail": {
+                "description": "Whether to fail if command returns non-zero exit code",
+                "default": true,
+                "type": "boolean"
+              },
+              "dir": {
+                "description": "Working directory for the command",
+                "type": "string"
+              },
+              "timing": {
+                "description": "When to run the command during preparation",
+                "default": "normal",
+                "type": "string",
+                "enum": ["early", "normal"]
+              }
+            },
+            "required": ["cmd"],
+            "additionalProperties": false
+          }
+        ]
+      }
+    },
+    "sites": {
+      "description": "Site-specific configuration overrides",
+      "type": "object",
+      "propertyNames": {
+        "type": "string"
+      },
+      "additionalProperties": {
+        "type": "object",
+        "propertyNames": {
+          "type": "string"
+        },
+        "additionalProperties": {
+          "type": "string"
+        }
+      }
+    },
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference for IDE support"
+    }
+  },
+  "additionalProperties": {
+    "type": "string"
+  },
+  "$id": "https://github.com/Jolt-Design/jolt-scripts/schema/jolt-config.json",
+  "title": "Jolt Scripts Configuration",
+  "description": "Configuration schema for Jolt Scripts DevOps automation tool",
+  "examples": [
+    {
+      "imageName": "my-app",
+      "awsRegion": "us-east-1",
+      "ecsCluster": "production-cluster",
+      "ecsService": "my-app-service",
+      "devEcsCluster": "dev-cluster",
+      "devEcsService": "my-app-dev-service",
+      "prepareCommands": [
+        "yarn install",
+        {
+          "cmd": "yarn build",
+          "name": "Build application",
+          "timing": "normal"
+        }
+      ],
+      "sites": {
+        "staging": {
+          "ecsCluster": "staging-cluster",
+          "ecsService": "my-app-staging"
+        }
+      }
+    }
+  ]
+}

package/package.json

@@ -1,36 +1,51 @@
 {
   "name": "@joltdesign/scripts",
-  "packageManager": "yarn@4.9.4+sha512.7b1cb0b62abba6a537b3a2ce00811a843bea02bcf53138581a6ae5b1bf563f734872bd47de49ce32a9ca9dcaff995aa789577ffb16811da7c603dcf69e73750b",
+  "packageManager": "yarn@4.10.3+sha512.c38cafb5c7bb273f3926d04e55e1d8c9dfa7d9c3ea1f36a4868fa028b9e5f72298f0b7f401ad5eb921749eb012eb1c3bb74bf7503df3ee43fd600d14a018266f",
   "bin": {
     "jolt": "./dist/cli.js"
   },
-  "version": "0.19.3",
+  "version": "0.21.0",
   "type": "module",
   "devDependencies": {
-    "@biomejs/biome": "^2.2.2",
-    "@types/node": "^24.3.0",
+    "@biomejs/biome": "^2.2.4",
+    "@types/node": "^24.6.1",
     "@types/which": "^3.0.4",
-    "typescript": "^5.9.2"
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "files": [
-    "/dist"
+    "/dist",
+    "jolt-config.schema.json"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc -b && yarn run generate-schema",
+    "clean": "rimraf dist",
     "debug": "node --inspect-brk ./dist/cli.js",
+    "generate-schema": "yarn node ./scripts/generate-schema.js && yarn lint --write jolt-config.schema.json",
     "lint": "biome check",
     "fmt": "biome format",
     "prepack": "run build",
     "prepare": "jolt prepare",
+    "release": "yarn test:run && yarn lint && && yarn clean && yarn build && git stash push -u -m 'temp stash for release' && npm version patch --tag-version-prefix='' --message='Version %s' && git push && git push --tags && yarn npm publish --access=public && git stash pop || true",
+    "release:minor": "yarn test:run && yarn lint && && yarn clean && yarn build && git stash push -u -m 'temp stash for release' && npm version minor --tag-version-prefix='' --message='Version %s' && git push && git push --tags && yarn npm publish --access=public && git stash pop || true",
+    "release:major": "yarn test:run && yarn lint && && yarn clean && yarn build && git stash push -u -m 'temp stash for release' && npm version major --tag-version-prefix='' --message='Version %s' && git push && git push --tags && yarn npm publish --access=public && git stash pop || true",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage.enabled=true",
+    "test:run": "vitest run",
     "watch": "tsc -w"
   },
   "dependencies": {
-    "ansis": "^4.1.0",
+    "ansis": "^4.2.0",
+    "change-case": "^5.4.4",
     "clipanion": "^4.0.0-rc.4",
-    "dotenv": "^17.2.2",
+    "dotenv": "^17.2.3",
     "execa": "^9.6.0",
     "object-resolve-path": "^1.1.1",
     "typanion": "^3.14.0",
-    "which": "^5.0.0"
+    "which": "^5.0.0",
+    "zod": "^4.1.11"
   }
 }