#!/usr/bin/env bash set -euo pipefail show_help() { cat <<'EOF' sf-deploy — wrapper for `sf project deploy start` USAGE: sf-deploy -o (-s ",[,...]" | -d ) [-t ",[,...]"] OPTIONS: -o Org alias or username for --target-org -s Comma-separated list of --source-dir paths -d Single directory path to deploy (alternative to -s) -t Comma-separated list of --tests (enables --test-level RunSpecifiedTests) -h Show this help EXAMPLES: 1) Real deploy with multiple flexipages (specific files): sf-deploy -o DEMO-ORG \ -s "force-app/main/default/flexipages/Sample_Page.flexipage-meta.xml,force-app/main/default/flexipages/Sample_Page_Backup_With_SalesNavigator.flexipage-meta.xml,force-app/main/default/flexipages/Sample_Role_Record_Page.flexipage-meta.xml" 2) Real deploy with entire directory: sf-deploy -o DEMO-ORG -d "force-app/main/default/classes" 3) Real deploy with specified tests: sf-deploy -o DEMO-ORG \ -s "force-app/main/default/flexipages/Demo_Page.flexipage-meta.xml,force-app/main/default/flexipages/Demo_Page_Backup_With_SalesNavigator.flexipage-meta.xml" \ -t "SelectorOpportunity_Test,SelectorOpportunity2_Test" Notes: - Use -s for specific files (comma-separated) OR -d for entire directories (not both). - Pass absolute or repo-relative paths. - Multiple tests are comma-separated in -t; they will be expanded to multiple --tests flags. EOF } ORG="" DIR_PATH="" declare -a SOURCES_ARR=() declare -a TESTS_ARR=() if [[ $# -eq 0 ]]; then show_help exit 0 fi while getopts ":o:s:d:t:h" opt; do case "$opt" in o) ORG="$OPTARG" ;; s) IFS=',' read -r -a SOURCES_ARR <<< "$OPTARG" ;; d) DIR_PATH="$OPTARG" ;; t) IFS=',' read -r -a TESTS_ARR <<< "$OPTARG" ;; h) show_help; exit 0 ;; \?) echo "Unknown option: -$OPTARG" >&2; echo; show_help; exit 1 ;; :) echo "Option -$OPTARG requires an argument." >&2; echo; show_help; exit 1 ;; esac done # Validate that either -s or -d is provided, but not both if [[ -n "$DIR_PATH" && ${#SOURCES_ARR[@]} -gt 0 ]]; then echo "Error: Cannot use both -s and -d options. Use -s for specific files or -d for directories." >&2 echo show_help exit 1 fi # Validate that at least one source option is provided if [[ -z "$DIR_PATH" && ${#SOURCES_ARR[@]} -eq 0 ]]; then echo "Error: Must provide either -s (specific files) or -d (directory path)." >&2 echo show_help exit 1 fi # Silent environment check - verify SF CLI is available if ! command -v sf >/dev/null 2>&1; then echo "❌ Salesforce CLI (sf) not found!" echo echo "Running environment check to help you get started..." echo # Try to find and run sf-check in the same directory as this script SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" if [[ -x "$SCRIPT_DIR/sf-check" ]]; then "$SCRIPT_DIR/sf-check" elif command -v sf-check >/dev/null 2>&1; then sf-check else echo "sf-check not found. Please install the Salesforce CLI from:" echo "https://developer.salesforce.com/tools/sfdxcli" fi exit 1 fi CMD=(sf project deploy start) # sources (specific files) for SRC in "${SOURCES_ARR[@]:-}"; do [[ -n "$SRC" ]] && CMD+=(--source-dir "$SRC") done # directory path [[ -n "$DIR_PATH" ]] && CMD+=(--source-dir "$DIR_PATH") # org [[ -n "$ORG" ]] && CMD+=(--target-org "$ORG") # tests if [[ ${#TESTS_ARR[@]:-0} -gt 0 ]]; then CMD+=(--test-level RunSpecifiedTests) for T in "${TESTS_ARR[@]}"; do [[ -n "$T" ]] && CMD+=(--tests "$T") done fi echo ">>> Running: ${CMD[*]}" exec "${CMD[@]}"