​

Gerenciando Acesso de Loaders/Actions

Por padrão, todos os loaders e actions no deco.cx são publicamente acessíveis. No entanto, você pode precisar restringir o acesso a certos loaders/actions que lidam com operações sensíveis ou APIs privadas. Este guia explica como controlar a visibilidade de loaders/actions.

​

Opções de Visibilidade

Existem dois níveis de visibilidade disponíveis:

• private: Pode ser invocado apenas no lado do servidor através do ctx.invoke
• public: Pode ser chamado tanto do servidor quanto do cliente através de:
  • Chamadas invoke em tempo de execução
  • Acesso direto via path /live/invoke/{path/to/block.ts}

​

Definindo Visibilidade Padrão

Para definir o nível de visibilidade de um loader/action, exporte uma variável defaultVisibility:

// Torna o loader publicamente acessível
export const defaultVisibility = 'public'

// Torna o loader privado (apenas lado do servidor)
export const defaultVisibility = 'private'

​

Sobrescrevendo Visibilidade

Você pode sobrescrever as configurações de visibilidade padrão no seu arquivo fresh.config.ts usando a opção visibilityOverrides:

import { defineConfig } from "$fresh/server.ts";
import { plugins } from "deco/plugins/deco.ts";
import manifest from "./manifest.gen.ts";

export default defineConfig({
  plugins: plugins<typeof manifest>({
    manifest,
    htmx: true,
    visibilityOverrides: {
      "site/loaders/minicart.ts": "public",
      "vtex/loaders/cart.ts": "private"
    },
  }),
});

​

Boas Práticas de Segurança

Ao decidir os níveis de visibilidade:

​

Use private para

• Acessar APIs privadas/internas
• Operações envolvendo credenciais ou segredos
• Processamento de dados sensíveis de usuários/negócios
• Integrações backend que requerem autenticação

​

Use public para

• Leitura de dados públicos de produtos
• Busca de conteúdo público
• Carregamento de dados no lado do cliente
• Operações voltadas ao usuário que não expõem dados sensíveis

​

Documentação Relacionada

• Buscando Dados
• Carregamento de Dados no Cliente
• Conceitos Principais: Loaders