Construa sobre o Lallek

Acesso de desenvolvedor

As ferramentas exigem uma conta autenticada e um perfil de desenvolvedor ativo. O pedido de perfil é feito dentro do Lallek e passa pela análise da equipe antes da ativação.

Crie e teste um applet

O Estúdio mantém cada projeto na sua conta, incrementa sua revisão a cada salvamento e oferece um preview em iframe isolado, sem acesso à rede ou à sessão do Lallek.

window.LallekPlugin = {
  id: 'meu-applet',

  mount(ctx) {
    ctx.root.innerHTML = `<button id="acao">Executar</button>`;
    ctx.root.querySelector('#acao').onclick = () => {
      ctx.emit('acao.executada', { origem: 'painel' });
    };
  },

  update(ctx) {
    console.log('Configuração atualizada', ctx.config);
  },

  unmount(ctx) {
    ctx.root.innerHTML = '';
  }
};

• mount(ctx) é obrigatório e recebe o contexto do runtime.
• update(ctx) pode reagir a mudanças de configuração.
• unmount(ctx) deve liberar interface e listeners criados pelo applet.
• O código persistido pode ter no máximo 200 KB.

Manifesto do projeto

O manifesto descreve a identidade, a versão e os recursos solicitados pelo applet. O identificador deve permanecer estável entre versões.

{
  "id": "meu-applet",
  "name": "Meu Applet",
  "version": "0.1.0",
  "author": "Sua organização",
  "category": "classroom",
  "runtime": "sandboxed",
  "entry": "main.js",
  "permissions": ["ui:panel"],
  "capabilities": {
    "panel": true,
    "toolbar": false,
    "backgroundTask": false
  }
}

Contexto de execução

O preview usa um iframe de origem opaca e aplica uma política de conteúdo que bloqueia conexões de rede. Imagens e mídia são limitadas a dados incorporados ou blobs locais.

Pacote .lallek-applet assinado

O botão Gerar pacote assinado salva o projeto, valida o manifesto no servidor e cria um documento v1 assinado com Ed25519. Cada arquivo e o payload completo recebem SHA-256 antes da assinatura.

Submissão, curadoria e publicação

Um perfil de desenvolvedor ativo pode usar Submeter à Loja. A ação salva o projeto, gera ou reutiliza exatamente a versão assinada e envia esse pacote à fila de curadoria.

Configure um endpoint

O Webhooks Manager envia requisições HTTP POST para uma URL HTTPS pública cadastrada pelo desenvolvedor. O segredo de assinatura aparece somente durante a criação ou rotação.

{
  "id": "uuid-do-evento",
  "event": "room.created",
  "created_at": "2026-08-18T18:00:00.000Z",
  "data": { "room_id": "...", "name": "..." }
}

Catálogo atual

Valide a assinatura HMAC

A assinatura é um HMAC SHA-256 de timestamp.corpo_bruto. Faça a verificação antes de interpretar o JSON e compare os hashes em tempo constante.

import { createHmac, timingSafeEqual } from 'node:crypto';

export function verifyLallekWebhook(rawBody, header, secret) {
  const parts = Object.fromEntries(
    header.split(',').map(part => part.split('=', 2))
  );
  const timestamp = Number(parts.t);
  if (!timestamp || Math.abs(Date.now() / 1000 - timestamp) > 300) {
    return false;
  }

  const expected = createHmac('sha256', secret)
    .update(`${parts.t}.${rawBody}`)
    .digest();
  const received = Buffer.from(parts.v1 || '', 'hex');

  return expected.length === received.length &&
    timingSafeEqual(expected, received);
}

Endpoints usados pelas ferramentas

O Estúdio e o Webhooks Manager usam estes endpoints do backend Lallek. Todos exigem a sessão do usuário; operações sensíveis também validam perfil ativo, posse e permissão no servidor.

Entrega, erros e proteção

• O endpoint deve responder com HTTP 2xx em até 10 segundos.
• Redirecionamentos não são seguidos; URLs locais, domínios internos e IPs literais são recusados.
• Cada tentativa registra status, código HTTP, duração, erro e próxima retentativa no histórico do proprietário.
• Falhas transitórias geram até cinco tentativas, com intervalos de 1, 5, 15 e 60 minutos.
• Entregas com falha podem ser reenviadas manualmente pelo histórico.
• Após dez falhas consecutivas, o endpoint é pausado automaticamente e pode ser reativado pelo proprietário.
• Guarde o segredo em um cofre ou variável de ambiente e renove-o imediatamente se houver exposição.
• Use o UUID do evento para tornar seu processamento idempotente.
• Responda rapidamente e envie trabalho demorado para uma fila do seu próprio sistema.