Function validateDeploymentID

internal/config/client.go:233–253

validateDeploymentID checks that the value looks like an Apps Script deployment ID and produces a hint when it looks like a common copy-paste mistake. The exact format Google uses isn't documented, but every observed ID starts with "AKfycb" and is 50+ characters long.

(id string)

// mistake. The exact format Google uses isn't documented, but every observed
// ID starts with "AKfycb" and is 50+ characters long.
func validateDeploymentID(id string) error {
	if id == "" {
		return errors.New("empty value in script_keys")
	}
	if id == "REPLACE_WITH_DEPLOYMENT_ID" || id == "OPTIONAL_SECOND_DEPLOYMENT_ID" {
		return errors.New("script_keys still contains the placeholder text from client_config.example.json — replace it with your real Deployment ID (see README Step 5)")
	}
	if strings.Contains(id, "/edit") || strings.Contains(id, "script.google.com/d/") {
		return errors.New("this looks like the Apps Script *editor* URL, not a Deployment ID. Open the deployment from Deploy → Manage deployments, click the deployed Web App URL, and copy the long string between /s/ and /exec")
	}
	if strings.ContainsAny(id, " \t\n\r") {
		return errors.New("script_keys value contains whitespace — paste the Deployment ID without spaces or line breaks")
	}
	if !strings.HasPrefix(id, "AKfycb") {
		return errors.New("deployment IDs start with 'AKfycb' — you may have pasted the script ID (from the editor) instead of the Deployment ID. After deploying, open Deploy → Manage deployments and copy the ID from the Web App URL")
	}
	if len(id) < 50 {
		return fmt.Errorf("deployment ID looks too short (%d chars; expected ~70) — it may be truncated, re-copy from Deploy → Manage deployments", len(id))
	}
	return nil
}

// parseSNIHosts parses the "sni" JSON field, which may be either a single
// string ("www.google.com") or an array (["www.google.com", "mail.google.com"]).