fix(kit): a mensagem "não encontrado" do reset-password volta a ser alcançável

O PR #552 de @Gervanno consertou a causa raiz: `owner_id_by_email` pedia
`?filter=email.eq.<email>`, sintaxe do PostgREST que o GoTrue não fala, e
devolvia vazio para todo mundo. Reproduzido contra o GoTrue local v2.188.1 e
confirmado — inclusive a exigência de casamento exato, porque o `filter` é
substring e `?filter=ana@empresa.com` também traz `mariana@empresa.com`.

Sobrou um resíduo que a triagem mediu no caminho de produção. `_common.sh` roda
sob `set -euo pipefail` e o consumidor resolve o UUID numa ATRIBUIÇÃO:

    uid="$(owner_id_by_email "$EMAIL")"
    [ -n "$uid" ] || die "Usuário '$EMAIL' não encontrado."

O status da atribuição é o da substituição de comando. O `grep` final devolve 1
quando não casa ninguém, então a função devolvia 1, e o `set -e` matava o script
na PRIMEIRA linha — a segunda, que existe justamente para o e-mail que não
existe, nunca rodava. Medido com as duas linhas reais contra o GoTrue local,
e-mail inexistente: rc=1 e nenhuma saída. Quem errasse uma letra no endereço
via o prompt de volta e mais nada.

Conserto: `|| return 0` no fim do pipeline. A função devolve VAZIO e quem chama
decide o que dizer — que é o contrato que o `[ -n "$uid" ] || die` já supunha.

O teste do PR guardava o call site por `grep` das duas linhas, o que prova que
elas existem e não que elas rodam. Acrescentei dois casos que EXECUTAM o call
site sob o `set -e` real. Sabotagem do conserto (revertendo só o `|| return 0`):
1 dos 11 casos reprova, e é o que descreve o resíduo.

Co-Authored-By: Elias Gervanno <vendiolabs@gmail.com>

Author: melgarafael

hostgator-setup-kit/_common.sh

@@ -668,6 +668,20 @@ set_env_var() {
 # Falha FECHADA: se o GoTrue mudar a ordem dos campos, o padrão não casa e a
 # função devolve vazio — quem chama morre com "não encontrado", que é ruim mas
 # recuperável. Devolver o UUID errado, não.
+#
+# ── Por que o `|| return 0` do fim não é enfeite ────────────────────────────
+# `_common.sh` roda sob `set -euo pipefail`, e o consumidor resolve o UUID numa
+# ATRIBUIÇÃO: `uid="$(owner_id_by_email "$EMAIL")"`. O status da atribuição é o
+# da substituição, então uma função que devolve não-zero mata o script ALI — na
+# linha de cima do `[ -n "$uid" ] || die "Usuário não encontrado."`, que nunca
+# chega a rodar. E o `grep` devolve 1 justamente quando não casa ninguém, que é
+# o caso em que a mensagem existe para falar.
+#
+# Medido em 2026-09-03 contra o GoTrue local v2.188.1, e-mail inexistente, as
+# duas linhas reais do reset-password.sh: rc=1 e NENHUMA saída — o operador que
+# erra uma letra no endereço não vê aviso nenhum, só o prompt de volta. "Não
+# encontrado" era uma mensagem inalcançável. O `|| return 0` põe a decisão onde
+# ela pertence: a função devolve VAZIO, e quem chama decide o que dizer.
 owner_id_by_email() {
   local email="$1" resp esc
   resp="$(curl -fsS "${NEXT_PUBLIC_SUPABASE_URL}/auth/v1/admin/users?filter=${email}" \
@@ -676,7 +690,7 @@ owner_id_by_email() {
   esc="$(printf '%s' "$email" | sed 's/[.[\*^$]/\\&/g')"
   printf '%s' "$resp" \
     | grep -o "\"id\":\"[0-9a-f-]\{36\}\",\"aud\":\"[^\"]*\",\"role\":\"[^\"]*\",\"email\":\"${esc}\"" \
-    | head -1 | sed 's/^"id":"//;s/".*//'
+    | head -1 | sed 's/^"id":"//;s/".*//' || return 0
 }
 
 # Ativa (idempotente) o cron que dispara o drain de eventos a cada minuto. SEM

tests/shell/owner-id-por-email.test.sh

@@ -133,6 +133,42 @@ check "reset-password.sh resolve o uid pela função" \
 check "reset-password.sh morre quando o uid vem vazio" \
   grep -qE '\[ -n "\$uid" \] \|\| die' "$KIT_DIR/reset-password.sh"
 
+printf '\n\u25b6 o call site EXECUTADO (grep de linha nao e comportamento)\n'
+
+# Os dois greps acima provam que as linhas EXISTEM. Nenhum prova que elas RODAM,
+# e era exatamente ali que morava o residuo: `_common.sh` roda sob
+# `set -euo pipefail` e o consumidor resolve o UUID numa ATRIBUICAO —
+# `uid="$(owner_id_by_email "$EMAIL")"`. O status da atribuicao e o da
+# substituicao, entao uma funcao que devolve nao-zero mata o script NA LINHA
+# ANTERIOR ao `[ -n "$uid" ] || die`. E o `grep` devolve 1 justamente quando nao
+# casa ninguem — o unico caso em que a mensagem tem o que dizer.
+#
+# Medido em 2026-09-03 contra o GoTrue local v2.188.1, e-mail inexistente, estas
+# duas linhas reais: rc=1 e NENHUMA saida. O operador que erra uma letra no
+# endereco nao via aviso nenhum, so o prompt de volta.
+cat > "$WORK/callsite.sh" <<'CALLSITE'
+. "$1"/_common.sh
+uid="$(owner_id_by_email "$2")"
+[ -n "$uid" ] || die "Usuario '$2' nao encontrado."
+printf 'ACHOU %s\n' "$uid"
+CALLSITE
+
+callsite() {  # callsite <email> -> o que o operador ve (stdout + stderr)
+  (
+    NEXT_PUBLIC_SUPABASE_URL="https://exemplo.supabase.co" \
+    SUPABASE_SERVICE_ROLE_KEY="chave-de-teste" COLOR=0 \
+    bash "$WORK/callsite.sh" "$KIT_DIR" "$1" 2>&1
+  )
+}
+
+check "o call site chega ao uid quando o e-mail existe" \
+  test "$(callsite 'ana@empresa.com')" = "ACHOU $ANA"
+
+# A guarda do residuo. Sem o `|| return 0` no fim de `owner_id_by_email`, esta
+# saida e a string VAZIA — nao a mensagem.
+check "e-mail inexistente: o operador VE 'nao encontrado' (o die e alcancavel)" \
+  bash -c 'case "$1" in *"nao encontrado"*) exit 0 ;; *) exit 1 ;; esac' _ "$(callsite 'ninguem@empresa.com')"
+
 printf '\n'
 [ "$FAILS" -eq 0 ] && { printf '✓ owner-id-por-email: tudo verde\n'; exit 0; }
 printf '✗ owner-id-por-email: %d falha(s)\n' "$FAILS"; exit 1