mirror of
https://github.com/forcedotcom/afv-library.git
synced 2026-08-09 00:42:46 +08:00
41 lines
2.1 KiB
Bash
41 lines
2.1 KiB
Bash
|
#!/usr/bin/env bash
|
||
|
|
set -euo pipefail # exit on error (-e), undefined vars (-u), and propagate pipeline failures (-o pipefail)
|
||
|
|
#
|
||
|
|
# check-org-api-version.sh — Verify a target org supports API v68.0+ (Release 264).
|
||
|
|
#
|
||
|
|
# Runtime label resolution over GraphQL for UI Bundles ships in Salesforce
|
||
|
|
# Release 264 (API v68.0+). A `sourceApiVersion` in sfdx-project.json records
|
||
|
|
# what you declared, not what the org supports, so a newer CLI pointed at an
|
||
|
|
# older org can pass a static file check and then fail at runtime. This queries
|
||
|
|
# the org's actual maximum API version before you wire anything.
|
||
|
|
#
|
||
|
|
# `sf api request rest` keeps authentication at the CLI transport layer, so no
|
||
|
|
# access token enters this script's context. Do not extract a token and curl.
|
||
|
|
#
|
||
|
|
# Usage:
|
||
|
|
# bash <skill-dir>/scripts/check-org-api-version.sh <org-alias-or-username>
|
||
|
|
#
|
||
|
|
# Exit codes:
|
||
|
|
# 0 org supports v68.0+ — proceed
|
||
|
|
# 1 org's max API version is below v68.0, or it could not be determined — stop
|
||
|
|
|
||
|
|
if [ "$#" -ne 1 ] || [ -z "${1:-}" ]; then
|
||
|
|
echo "ERROR: pass exactly one org alias or username. Usage: check-org-api-version.sh <org-alias-or-username>" >&2
|
||
|
|
exit 1
|
||
|
|
fi
|
||
|
|
ORG="$1"
|
||
|
|
|
||
|
|
# FORCE_COLOR=0 stops the CLI from emitting ANSI color codes into stdout JSON,
|
||
|
|
# which would otherwise make jq fail with "Invalid numeric literal".
|
||
|
|
MAX_API=$(FORCE_COLOR=0 sf api request rest "/services/data/" --target-org "$ORG" \
|
||
|
|
| jq -r '[.[].version | tonumber] | max') \
|
||
|
|
|| { echo "ERROR: could not determine the target org's API version (auth or network problem?). Verify the org is reachable, then retry." >&2; exit 1; }
|
||
|
|
|
||
|
|
[ -n "$MAX_API" ] && [ "$MAX_API" != "null" ] \
|
||
|
|
|| { echo "ERROR: the org returned an empty API version. Verify the target org and retry." >&2; exit 1; }
|
||
|
|
|
||
|
|
awk -v v="$MAX_API" 'BEGIN{ exit !(v+0 >= 68.0) }' \
|
||
|
|
|| { echo "ERROR: runtime label localization for UI Bundles requires Salesforce Release 264 (API v68.0+). Target org's maximum supported API version is v${MAX_API}. Retarget a Release 264+ org, or upgrade the org before adding localization." >&2; exit 1; }
|
||
|
|
|
||
|
|
echo "OK: target org '${ORG}' supports API v${MAX_API} (>= v68.0). Proceed."
|