@neetru/cli 2.11.2 → 2.11.4

package/dist/lib/ai/context.js

@@ -4,91 +4,91 @@
  * auth, billing e schema Firestore para que o modelo gere código
  * que já conecta corretamente na plataforma.
  */
-export const NEETRU_SYSTEM_CONTEXT = `
-Você é o assistente de desenvolvimento do ecossistema Neetru.
-Ajuda devs a construir produtos SaaS de cima da plataforma Neetru Core.
-
-═══════════════════════════════════════
-NEETRU CORE — SUPERFÍCIE DE API
-═══════════════════════════════════════
-
-Base URL: https://api.neetru.com
-Auth: Bearer token (neetru-api-key) no header Authorization
-
-── Tenants ─────────────────────────────
-GET    /tenants                    lista tenants do usuário autenticado
-POST   /tenants                    cria tenant { name, plan, metadata }
-GET    /tenants/:id                detalhe do tenant
-PATCH  /tenants/:id                atualiza nome/metadata
-DELETE /tenants/:id                soft-delete (status: arquivado)
-
-── Entitlements ────────────────────────
-GET    /entitlements/:tenantId     features ativas para o tenant
-  Resposta: { features: string[], plan: string, limits: {...} }
-
-── Subscriptions ───────────────────────
-GET    /subscriptions/:tenantId    assinatura ativa
-POST   /subscriptions/checkout     inicia checkout Stripe { tenantId, planId }
-DELETE /subscriptions/:id          cancela no fim do período
-
-── Billing / Invoices ──────────────────
-GET    /invoices?tenantId=X        lista faturas
-GET    /invoices/:id/pdf           download PDF da fatura
-
-── Webhook ─────────────────────────────
-POST   /webhooks/stripe            recebe eventos Stripe (configurar no dashboard)
-
-═══════════════════════════════════════
-PADRÕES DE INTEGRAÇÃO
-═══════════════════════════════════════
-
-Auth em Next.js (App Router):
-  import { createCustomerSession } from '@neetru/sdk';
-  // No server action após login Firebase:
-  await createCustomerSession(idToken);
-
-Tenant gate (middleware):
-  import { withTenantGate } from '@neetru/sdk/middleware';
-  export const middleware = withTenantGate({ requiredFeature: 'feature-x' });
-
-Verificar entitlement em Server Action:
-  import { getEntitlements } from '@neetru/sdk/server';
-  const { features } = await getEntitlements(tenantId);
-  if (!features.includes('advanced-reports')) throw new Error('Plano insuficiente');
-
-Firestore collections relevantes (Admin SDK no Core):
-  tenants/{tenantId}         → dados do tenant
-  subscriptions/{id}         → assinatura (userId, tenantId, planId, status)
-  account_invoices/{id}      → faturas
-  payment_methods/{id}       → métodos de pagamento
-  support_tickets/{id}       → tickets de suporte
-  audit_logs/{id}            → auditoria append-only (NÃO escrever diretamente)
-  public_products/{slug}     → catálogo público (leitura pública, escrita via Core)
-
-═══════════════════════════════════════
-REGRAS DO ECOSSISTEMA
-═══════════════════════════════════════
-
-1. Todo produto SaaS usa tenants do Core — não crie autenticação própria.
-2. Billing sempre via Core → Stripe. Nunca cobrar diretamente.
-3. Auditoria: use recordAudit() do Core SDK — nunca escrever em audit_logs diretamente.
-4. Entitlements: verificar features ANTES de renderizar funcionalidades premium.
-5. LGPD: dados pessoais só no Firestore, nunca em logs. Soft delete padrão.
-6. Deploy: via 'neetru deploy' — não usar gcloud diretamente nos produtos.
-
-═══════════════════════════════════════
-STACK PADRÃO DOS PRODUTOS
-═══════════════════════════════════════
-
-Frontend: Next.js 15 (App Router) + shadcn/ui + Tailwind
-Backend: Next.js Server Actions + Firebase Admin SDK
-Auth: Firebase Auth → Core session cookie
-DB: Firestore (Admin SDK no servidor, client SDK leitura em tempo real)
-Infra: Cloud Run (gerenciado pelo Core)
-Brand: tokens do BRAND.md — brand-500, brand-700, ink-950, neetru-slate-*
-
-Quando gerar código, siga este stack. Não sugira alternativas de infra
-(não é Railway, Vercel, Supabase — é o Core da Neetru).
+export const NEETRU_SYSTEM_CONTEXT = `
+Você é o assistente de desenvolvimento do ecossistema Neetru.
+Ajuda devs a construir produtos SaaS de cima da plataforma Neetru Core.
+
+═══════════════════════════════════════
+NEETRU CORE — SUPERFÍCIE DE API
+═══════════════════════════════════════
+
+Base URL: https://api.neetru.com
+Auth: Bearer token (neetru-api-key) no header Authorization
+
+── Tenants ─────────────────────────────
+GET    /tenants                    lista tenants do usuário autenticado
+POST   /tenants                    cria tenant { name, plan, metadata }
+GET    /tenants/:id                detalhe do tenant
+PATCH  /tenants/:id                atualiza nome/metadata
+DELETE /tenants/:id                soft-delete (status: arquivado)
+
+── Entitlements ────────────────────────
+GET    /entitlements/:tenantId     features ativas para o tenant
+  Resposta: { features: string[], plan: string, limits: {...} }
+
+── Subscriptions ───────────────────────
+GET    /subscriptions/:tenantId    assinatura ativa
+POST   /subscriptions/checkout     inicia checkout Stripe { tenantId, planId }
+DELETE /subscriptions/:id          cancela no fim do período
+
+── Billing / Invoices ──────────────────
+GET    /invoices?tenantId=X        lista faturas
+GET    /invoices/:id/pdf           download PDF da fatura
+
+── Webhook ─────────────────────────────
+POST   /webhooks/stripe            recebe eventos Stripe (configurar no dashboard)
+
+═══════════════════════════════════════
+PADRÕES DE INTEGRAÇÃO
+═══════════════════════════════════════
+
+Auth em Next.js (App Router):
+  import { createCustomerSession } from '@neetru/sdk';
+  // No server action após login Firebase:
+  await createCustomerSession(idToken);
+
+Tenant gate (middleware):
+  import { withTenantGate } from '@neetru/sdk/middleware';
+  export const middleware = withTenantGate({ requiredFeature: 'feature-x' });
+
+Verificar entitlement em Server Action:
+  import { getEntitlements } from '@neetru/sdk/server';
+  const { features } = await getEntitlements(tenantId);
+  if (!features.includes('advanced-reports')) throw new Error('Plano insuficiente');
+
+Firestore collections relevantes (Admin SDK no Core):
+  tenants/{tenantId}         → dados do tenant
+  subscriptions/{id}         → assinatura (userId, tenantId, planId, status)
+  account_invoices/{id}      → faturas
+  payment_methods/{id}       → métodos de pagamento
+  support_tickets/{id}       → tickets de suporte
+  audit_logs/{id}            → auditoria append-only (NÃO escrever diretamente)
+  public_products/{slug}     → catálogo público (leitura pública, escrita via Core)
+
+═══════════════════════════════════════
+REGRAS DO ECOSSISTEMA
+═══════════════════════════════════════
+
+1. Todo produto SaaS usa tenants do Core — não crie autenticação própria.
+2. Billing sempre via Core → Stripe. Nunca cobrar diretamente.
+3. Auditoria: use recordAudit() do Core SDK — nunca escrever em audit_logs diretamente.
+4. Entitlements: verificar features ANTES de renderizar funcionalidades premium.
+5. LGPD: dados pessoais só no Firestore, nunca em logs. Soft delete padrão.
+6. Deploy: via 'neetru deploy' — não usar gcloud diretamente nos produtos.
+
+═══════════════════════════════════════
+STACK PADRÃO DOS PRODUTOS
+═══════════════════════════════════════
+
+Frontend: Next.js 15 (App Router) + shadcn/ui + Tailwind
+Backend: Next.js Server Actions + Firebase Admin SDK
+Auth: Firebase Auth → Core session cookie
+DB: Firestore (Admin SDK no servidor, client SDK leitura em tempo real)
+Infra: Cloud Run (gerenciado pelo Core)
+Brand: tokens do BRAND.md — brand-500, brand-700, ink-950, neetru-slate-*
+
+Quando gerar código, siga este stack. Não sugira alternativas de infra
+(não é Railway, Vercel, Supabase — é o Core da Neetru).
 `.trim();
 /**
  * Contexto adicional de projeto — lido do .neetru.json no diretório atual.
@@ -98,11 +98,11 @@ export async function loadProjectContext() {
         const fs = await import('fs/promises');
         const raw = await fs.readFile('.neetru.json', 'utf-8');
         const project = JSON.parse(raw);
-        return `
-Projeto atual: ${project.name ?? 'desconhecido'}
-Tipo: ${project.type ?? 'saas-product'}
-Tenant: ${project.tenantId ?? 'não configurado'}
-Features: ${(project.features ?? []).join(', ') || 'nenhuma configurada'}
+        return `
+Projeto atual: ${project.name ?? 'desconhecido'}
+Tipo: ${project.type ?? 'saas-product'}
+Tenant: ${project.tenantId ?? 'não configurado'}
+Features: ${(project.features ?? []).join(', ') || 'nenhuma configurada'}
     `.trim();
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neetru/cli",
-  "version": "2.11.2",
+  "version": "2.11.4",
   "type": "module",
   "description": "Neetru Developer Kit — scaffold, AI assistant, publish, build e deploy de produtos SaaS Neetru via Core (VM-based agents)",
   "keywords": [

package/templates/auth/callback.ts

@@ -1,22 +1,22 @@
-/**
- * Template — `src/lib/neetru/auth/callback.ts` (gerado por `neetru add auth`).
- *
- * Handler de callback OIDC (auth code → id_token). Use em `app/oauth/callback/route.ts`.
- */
-import { NextRequest, NextResponse } from 'next/server';
-
-export const runtime = 'nodejs';
-
-export async function GET(request: NextRequest) {
-  const { searchParams } = new URL(request.url);
-  const code = searchParams.get('code');
-  const state = searchParams.get('state');
-
-  if (!code) {
-    return NextResponse.json({ error: 'missing_code' }, { status: 400 });
-  }
-
-  // Trocar code → id_token contra auth.neetru.com/token
-  // Implementação detalhada em docs/PLATFORM_AUTH.md §4
-  return NextResponse.redirect(state ?? '/');
-}
+/**
+ * Template — `src/lib/neetru/auth/callback.ts` (gerado por `neetru add auth`).
+ *
+ * Handler de callback OIDC (auth code → id_token). Use em `app/oauth/callback/route.ts`.
+ */
+import { NextRequest, NextResponse } from 'next/server';
+
+export const runtime = 'nodejs';
+
+export async function GET(request: NextRequest) {
+  const { searchParams } = new URL(request.url);
+  const code = searchParams.get('code');
+  const state = searchParams.get('state');
+
+  if (!code) {
+    return NextResponse.json({ error: 'missing_code' }, { status: 400 });
+  }
+
+  // Trocar code → id_token contra auth.neetru.com/token
+  // Implementação detalhada em docs/PLATFORM_AUTH.md §4
+  return NextResponse.redirect(state ?? '/');
+}

package/templates/auth/sign-in.tsx

@@ -1,41 +1,41 @@
-/**
- * Template — `src/lib/neetru/auth/sign-in.tsx` (gerado por `neetru add auth`).
- *
- * Botão Google → redireciona pra auth.neetru.com via SDK (`client.auth.signIn`).
- *
- * Customização: ajuste `redirectUri` se hospedar fora do domínio default.
- */
-'use client';
-
-import { useState } from 'react';
-import { createNeetruClient } from '@neetru/sdk';
-
-const client = createNeetruClient({
-  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
-  productId: process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID,
-});
-
-export function SignInButton() {
-  const [loading, setLoading] = useState(false);
-
-  async function handleSignIn() {
-    setLoading(true);
-    try {
-      await client.auth.signIn();
-    } catch (err) {
-      console.error('signIn failed', err);
-      setLoading(false);
-    }
-  }
-
-  return (
-    <button
-      type="button"
-      onClick={handleSignIn}
-      disabled={loading}
-      className="inline-flex items-center justify-center px-4 py-2 border bg-white hover:bg-zinc-50 text-zinc-900 font-medium"
-    >
-      {loading ? 'Redirecionando...' : 'Entrar com Neetru'}
-    </button>
-  );
-}
+/**
+ * Template — `src/lib/neetru/auth/sign-in.tsx` (gerado por `neetru add auth`).
+ *
+ * Botão Google → redireciona pra auth.neetru.com via SDK (`client.auth.signIn`).
+ *
+ * Customização: ajuste `redirectUri` se hospedar fora do domínio default.
+ */
+'use client';
+
+import { useState } from 'react';
+import { createNeetruClient } from '@neetru/sdk';
+
+const client = createNeetruClient({
+  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
+  productId: process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID,
+});
+
+export function SignInButton() {
+  const [loading, setLoading] = useState(false);
+
+  async function handleSignIn() {
+    setLoading(true);
+    try {
+      await client.auth.signIn();
+    } catch (err) {
+      console.error('signIn failed', err);
+      setLoading(false);
+    }
+  }
+
+  return (
+    <button
+      type="button"
+      onClick={handleSignIn}
+      disabled={loading}
+      className="inline-flex items-center justify-center px-4 py-2 border bg-white hover:bg-zinc-50 text-zinc-900 font-medium"
+    >
+      {loading ? 'Redirecionando...' : 'Entrar com Neetru'}
+    </button>
+  );
+}

package/templates/billing/checkout.ts

@@ -1,22 +1,22 @@
-/**
- * Template — `src/lib/neetru/billing/checkout.ts` (gerado por `neetru add billing`).
- *
- * Inicia checkout Stripe via Core. Server route handler.
- */
-import { NextRequest, NextResponse } from 'next/server';
-
-export const runtime = 'nodejs';
-
-export async function POST(request: NextRequest) {
-  const body = await request.json();
-  const slug = body?.slug as string | undefined;
-  if (!slug) {
-    return NextResponse.json({ error: 'slug required' }, { status: 400 });
-  }
-
-  // Hit Core REST: POST /api/v1/billing/checkout
-  // (Sprint 9 expõe via SDK direto)
-  return NextResponse.json({
-    redirectUrl: `https://minhaconta.neetru.com/checkout?slug=${slug}`,
-  });
-}
+/**
+ * Template — `src/lib/neetru/billing/checkout.ts` (gerado por `neetru add billing`).
+ *
+ * Inicia checkout Stripe via Core. Server route handler.
+ */
+import { NextRequest, NextResponse } from 'next/server';
+
+export const runtime = 'nodejs';
+
+export async function POST(request: NextRequest) {
+  const body = await request.json();
+  const slug = body?.slug as string | undefined;
+  if (!slug) {
+    return NextResponse.json({ error: 'slug required' }, { status: 400 });
+  }
+
+  // Hit Core REST: POST /api/v1/billing/checkout
+  // (Sprint 9 expõe via SDK direto)
+  return NextResponse.json({
+    redirectUrl: `https://minhaconta.neetru.com/checkout?slug=${slug}`,
+  });
+}

package/templates/billing/page.tsx

@@ -1,43 +1,43 @@
-/**
- * Template — `src/lib/neetru/billing/page.tsx` (gerado por `neetru add billing`).
- *
- * Página simples: lista planos + botão checkout via SDK.
- */
-'use client';
-
-import { useEffect, useState } from 'react';
-import { createNeetruClient, type Product } from '@neetru/sdk';
-
-const client = createNeetruClient({
-  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
-});
-
-export default function BillingPage() {
-  const [products, setProducts] = useState<Product[]>([]);
-  useEffect(() => {
-    client.catalog
-      .list()
-      .then(({ products }) => setProducts(products))
-      .catch((err) => console.error(err));
-  }, []);
-
-  return (
-    <main className="p-8">
-      <h1 className="text-3xl font-bold mb-6">Planos</h1>
-      <div className="grid gap-4 md:grid-cols-3">
-        {products.map((p) => (
-          <article key={p.slug} className="border p-6">
-            <h2 className="text-xl font-semibold">{p.name}</h2>
-            <p className="text-sm text-zinc-600 mt-1">{p.tagline}</p>
-            <a
-              href={`/checkout?slug=${p.slug}`}
-              className="inline-block mt-4 px-4 py-2 bg-zinc-900 text-white"
-            >
-              Assinar
-            </a>
-          </article>
-        ))}
-      </div>
-    </main>
-  );
-}
+/**
+ * Template — `src/lib/neetru/billing/page.tsx` (gerado por `neetru add billing`).
+ *
+ * Página simples: lista planos + botão checkout via SDK.
+ */
+'use client';
+
+import { useEffect, useState } from 'react';
+import { createNeetruClient, type Product } from '@neetru/sdk';
+
+const client = createNeetruClient({
+  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
+});
+
+export default function BillingPage() {
+  const [products, setProducts] = useState<Product[]>([]);
+  useEffect(() => {
+    client.catalog
+      .list()
+      .then(({ products }) => setProducts(products))
+      .catch((err) => console.error(err));
+  }, []);
+
+  return (
+    <main className="p-8">
+      <h1 className="text-3xl font-bold mb-6">Planos</h1>
+      <div className="grid gap-4 md:grid-cols-3">
+        {products.map((p) => (
+          <article key={p.slug} className="border p-6">
+            <h2 className="text-xl font-semibold">{p.name}</h2>
+            <p className="text-sm text-zinc-600 mt-1">{p.tagline}</p>
+            <a
+              href={`/checkout?slug=${p.slug}`}
+              className="inline-block mt-4 px-4 py-2 bg-zinc-900 text-white"
+            >
+              Assinar
+            </a>
+          </article>
+        ))}
+      </div>
+    </main>
+  );
+}

package/templates/support/ticket-form.tsx

@@ -1,68 +1,68 @@
-/**
- * Template — `src/lib/neetru/support/ticket-form.tsx` (gerado por `neetru add support`).
- *
- * Form de suporte: cria ticket via SDK.
- */
-'use client';
-
-import { useState } from 'react';
-import { createNeetruClient } from '@neetru/sdk';
-
-const client = createNeetruClient({
-  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
-});
-
-export function SupportTicketForm() {
-  const [subject, setSubject] = useState('');
-  const [message, setMessage] = useState('');
-  const [submitting, setSubmitting] = useState(false);
-  const [result, setResult] = useState<string | null>(null);
-
-  async function handleSubmit(e: React.FormEvent) {
-    e.preventDefault();
-    setSubmitting(true);
-    try {
-      const ticket = await client.support.createTicket({ subject, message });
-      setResult(`Ticket criado: ${ticket.id}`);
-      setSubject('');
-      setMessage('');
-    } catch (err) {
-      setResult('Falha ao criar ticket.');
-      console.error(err);
-    } finally {
-      setSubmitting(false);
-    }
-  }
-
-  return (
-    <form onSubmit={handleSubmit} className="grid gap-3 max-w-md">
-      <label className="grid gap-1">
-        <span className="text-sm font-medium">Assunto</span>
-        <input
-          required
-          value={subject}
-          onChange={(e) => setSubject(e.target.value)}
-          className="border px-3 py-2"
-        />
-      </label>
-      <label className="grid gap-1">
-        <span className="text-sm font-medium">Mensagem</span>
-        <textarea
-          required
-          rows={5}
-          value={message}
-          onChange={(e) => setMessage(e.target.value)}
-          className="border px-3 py-2"
-        />
-      </label>
-      <button
-        type="submit"
-        disabled={submitting}
-        className="px-4 py-2 bg-zinc-900 text-white"
-      >
-        {submitting ? 'Enviando...' : 'Enviar'}
-      </button>
-      {result && <p className="text-sm">{result}</p>}
-    </form>
-  );
-}
+/**
+ * Template — `src/lib/neetru/support/ticket-form.tsx` (gerado por `neetru add support`).
+ *
+ * Form de suporte: cria ticket via SDK.
+ */
+'use client';
+
+import { useState } from 'react';
+import { createNeetruClient } from '@neetru/sdk';
+
+const client = createNeetruClient({
+  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
+});
+
+export function SupportTicketForm() {
+  const [subject, setSubject] = useState('');
+  const [message, setMessage] = useState('');
+  const [submitting, setSubmitting] = useState(false);
+  const [result, setResult] = useState<string | null>(null);
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    setSubmitting(true);
+    try {
+      const ticket = await client.support.createTicket({ subject, message });
+      setResult(`Ticket criado: ${ticket.id}`);
+      setSubject('');
+      setMessage('');
+    } catch (err) {
+      setResult('Falha ao criar ticket.');
+      console.error(err);
+    } finally {
+      setSubmitting(false);
+    }
+  }
+
+  return (
+    <form onSubmit={handleSubmit} className="grid gap-3 max-w-md">
+      <label className="grid gap-1">
+        <span className="text-sm font-medium">Assunto</span>
+        <input
+          required
+          value={subject}
+          onChange={(e) => setSubject(e.target.value)}
+          className="border px-3 py-2"
+        />
+      </label>
+      <label className="grid gap-1">
+        <span className="text-sm font-medium">Mensagem</span>
+        <textarea
+          required
+          rows={5}
+          value={message}
+          onChange={(e) => setMessage(e.target.value)}
+          className="border px-3 py-2"
+        />
+      </label>
+      <button
+        type="submit"
+        disabled={submitting}
+        className="px-4 py-2 bg-zinc-900 text-white"
+      >
+        {submitting ? 'Enviando...' : 'Enviar'}
+      </button>
+      {result && <p className="text-sm">{result}</p>}
+    </form>
+  );
+}