Skip to main content
Toda função desenvolvida para o Analytics Lab segue uma estrutura limpa e padronizada. Esta estrutura garante que o CLI sanalytics consiga identificar as configurações da função e que o ambiente serverless execute o handler corretamente.

📁 Layout de Arquivos

Uma pasta de função no Analytics Lab deve conter os seguintes arquivos:

Para Node.js (node22 / JavaScript / TypeScript):

Para Python (python3.12):


⚙️ Manifesto sanalytics.json

O arquivo sanalytics.json conecta a sua pasta local à função registrada no Analytics Lab. Ele é gerado automaticamente pelo comando sanalytics create.

Campos:

  • function_id: Identificador UUID v7 da função no Analytics Lab.
  • name: Nome legível da função.
  • slug: Slug da função.
  • runtime: Ambiente de execução (node22 ou python3.12).
  • entrypoint: Arquivo e nome da função exportada no formato arquivo.extensão:funcao.

🧩 Contrato da Função handler

Toda função executada no Analytics Lab deve exportar uma função assíncrona chamada handler (ou o nome configurado no entrypoint).

Exemplo em JavaScript (Node.js ESM)

Exemplo em Python


🚫 Arquivos Ignorados (.gitignore)

O CLI sanalytics ignora automaticamente pastas de dependências locais e arquivos temporários ao compactar e enviar a função para teste ou deploy:
Importante: Nunca envie a pasta node_modules/ ou .venv/. O Analytics Lab cuida da instalação e otimização das dependências automaticamente no ambiente sandbox.