Janus CMS

Hierarquia multi-tenant

O Janus CMS isola dados por Company. Cada Company contém Projects; cada Project contém Pages. Esta hierarquia garante que nenhuma query vaze dados entre tenants — o companyId é chave estrangeira obrigatória em todas as entidades filhas.

Company  (id: UUID, slug: unique, name: string)
  └─ Project  (type: LANDING_PAGE | INSTITUTIONAL,
               blogEnabled: bool, isActive: bool)
       └─ Page  (schemaData: JSON,
                 contentData: JSON,
                 isAdvanced:  bool,   // false = Legacy | true = Avançado
                 uiSchema:    JSON?,  // controle de labels/widgets (opcional)
                 isPublished: bool,
                 slug: unique per project,
                 deletedAt: nullable)

Todas as entidades possuem soft delete via deletedAt. Consultas filtram deletedAt: null por padrão.

Dois modos de edição: Legacy e Avançado

O campo isAdvanced da Page determina qual modo está ativo. A troca de modo nunca apaga dados — apenas muda a flag via updatePageMode().

Tipos de campo suportados no modo Legacy:

{
  "cards.*.image":       { "ui:widget": "image" },
  "cards.*.buttonText":  { "ui:label": "Texto do Botão" },
  "internalId":          { "ui:hidden": true }
}

API REST pública headless

A API REST do Janus é pública, CORS-aberta e projetada para ser consumida por React Server Components. A resposta do servidor ocorre em <50ms; com s-maxage=60, a Vercel Edge Network serve o cache em <10ms.

GET /api/v1/content/{companySlug}/{pageSlug}

Headers de resposta:
  Cache-Control: public, max-age=60, s-maxage=60
  Access-Control-Allow-Origin: *

Body 200 — OK:
{
  "slug":      "home",
  "name":      "Página Inicial",
  "schema":    { ... },   // schemaData (estrutura ou JSON livre)
  "content":   { ... },   // contentData (modo legacy) ou null (modo avançado)
  "updatedAt": "2026-05-16T00:00:00.000Z"
}

Requisitos para HTTP 200:
  page.isPublished  = true
  project.isActive  = true
  company.deletedAt = null

Body 404 — Not Found:
{ "error": "Page not found or not published" }

Instalação

Disponível como workspace package no monorepo Mavellium. Adicione ao package.json do seu projeto Next.js:

{
  "dependencies": {
    "janus-sdk": "workspace:*"
  }
}

Depois rode pnpm install na raiz do monorepo. O pnpm cria um symlink para janus-sdk/dist/.

Inicialização (singleton recomendado)

// src/lib/janus.ts
import { JanusClient } from "janus-sdk";

export const janus = new JanusClient({
  baseUrl:     process.env.JANUS_URL!,
  tenantId:    process.env.JANUS_TENANT_ID!,
  defaultInit: {
    next: { revalidate: 60 }, // ISR — revalida a cada 60s
  } as RequestInit,
});

Erros tipados

O SDK expõe JanusAPIError com o código HTTP e a URL que falhou:

export class JanusAPIError extends Error {
  readonly status: number  // ex: 500, 503
  readonly url:    string  // URL completa que falhou
}