[Airtable] I'm pretty sure refresh token is not working

[lucis]

After a couple of hours, it starts giving errors.

I'm still trying to investigate it

[decobot]

💡 Solução Detalhada - Refresh Token do Airtable

Analisei o código em airtable/mod.ts e identifiquei potenciais problemas na implementação do refresh token.

🔍 Problemas Identificados

1. Callback onTokenRefresh pode falhar silenciosamente (linhas 96-103)
2. customRefreshFunction não valida a resposta (linhas 104-127)
3. Falta logging para debug de erros de refresh

📝 Correções Necessárias

1. Melhorar validação e error handling na customRefreshFunction:

// airtable/mod.ts (linha 104)
customRefreshFunction: async (params: {
  refresh_token: string;
  client_id: string;
  client_secret: string;
}) => {
  try {
    const response = await fetch(OAUTH_URL_TOKEN, {
      method: "POST",
      headers: {
        "Content-Type": "application/x-www-form-urlencoded",
        "Accept": "application/json",
        "Authorization": `Basic ${btoa(`${params.client_id}:${params.client_secret}`)}`,
      },
      body: new URLSearchParams({
        grant_type: "refresh_token",
        refresh_token: params.refresh_token,
        client_id: params.client_id,
        client_secret: params.client_secret,
      }),
    });

    if (!response.ok) {
      const errorText = await response.text();
      console.error("[Airtable] Token refresh failed:", {
        status: response.status,
        statusText: response.statusText,
        error: errorText,
      });
      throw new Error(`Token refresh failed: ${response.status} ${errorText}`);
    }

    const data = await response.json();
    
    // Validar que os campos necessários estão presentes
    if (!data.access_token) {
      throw new Error("Token refresh response missing access_token");
    }

    console.log("[Airtable] Token refreshed successfully");
    return data;
  } catch (error) {
    console.error("[Airtable] Error refreshing token:", error);
    throw error;
  }
},

2. Melhorar o onTokenRefresh callback:

// airtable/mod.ts (linha 96)
onTokenRefresh: async (newTokens: OAuthTokens) => {
  try {
    if (!ctx || !ctx.configure) {
      console.error("[Airtable] Cannot save refreshed tokens: ctx.configure not available");
      return;
    }

    console.log("[Airtable] Saving refreshed tokens...");
    await ctx.configure({
      ...ctx,
      tokens: newTokens,
    });
    console.log("[Airtable] Tokens saved successfully");
  } catch (error) {
    console.error("[Airtable] Failed to save refreshed tokens:", error);
    // Não faça throw aqui, pois o token já foi refreshed na API
    // O erro aqui é apenas sobre persistência
  }
},

3. Adicionar verificação de token expirado:

Crie um utilitário para verificar se o token está expirando:

// airtable/utils/token.ts (novo arquivo)
export function isTokenExpiringSoon(tokens: OAuthTokens | undefined, bufferSeconds = 300): boolean {
  if (!tokens?.expires_at) return true;
  
  const expiresAt = typeof tokens.expires_at === "string" 
    ? new Date(tokens.expires_at).getTime()
    : tokens.expires_at;
  
  const now = Date.now();
  const expiresIn = expiresAt - now;
  
  return expiresIn < bufferSeconds * 1000;
}

🧪 Como Testar

1. Adicione logs temporários:

console.log("[Airtable Debug]", {
  hasTokens: !!tokens,
  hasRefreshToken: !!tokens?.refresh_token,
  expiresAt: tokens?.expires_at,
  clientIdPresent: !!clientId,
  clientSecretPresent: !!clientSecret,
});

2. Force um refresh modificando temporariamente o expires_at
3. Monitore os logs para ver se o refresh acontece e se os tokens são salvos

✅ Checklist

• Adicionar error handling robusto na customRefreshFunction
• Adicionar logs de debug (remover em produção)
• Validar resposta do refresh antes de retornar
• Garantir que ctx.configure está funcionando
• Testar com token expirado real
• Verificar que o novo token é persistido corretamente

🔍 Área de Investigação

Se o problema persistir, verifique:

• Se ctx.configure() realmente persiste as mudanças
• Se há rate limiting no Airtable bloqueando o refresh
• Se o refresh_token está sendo retornado na primeira autenticação