@neetru/cli 2.24.1 → 2.26.0

package/templates/billing/page.tsx

@@ -1,43 +1,84 @@
-/**
- * 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/app/(marketing)/billing/page.tsx` (gerado por `neetru add billing`).
+ *
+ * Página de planos: lista os planos do produto e usa <CheckoutLink> do SDK
+ * pra redirecionar ao Stripe. O <CheckoutLink> usa OIDC — o usuário precisa
+ * estar logado (veja `neetru add auth`).
+ *
+ * Pré-requisito: NEXT_PUBLIC_NEETRU_API_KEY e NEXT_PUBLIC_NEETRU_PRODUCT_ID
+ * no .env.local.
+ */
+'use client';
+
+import { createNeetruClient } from '@neetru/sdk';
+import { CheckoutLink } from '@neetru/sdk/react';
+import { useEffect, useState } from 'react';
+
+const client = createNeetruClient({
+  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY!,
+  productId: process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID!,
+});
+
+interface Plan {
+  id: string;
+  name: string;
+  description: string;
+  price: string;
+  slug: string;
+}
+
+export default function BillingPage() {
+  const [plans, setPlans] = useState<Plan[]>([]);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    client.catalog
+      .list()
+      .then(({ products }) => {
+        const product = products.find(
+          (p) => p.id === process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID,
+        );
+        setPlans(
+          product?.plans?.map((plan: { id: string; name: string; description?: string; amount?: number; interval?: string; slug?: string }) => ({
+            id: plan.id,
+            name: plan.name,
+            description: plan.description ?? '',
+            price: plan.amount ? `R$ ${(plan.amount / 100).toFixed(2)}/${plan.interval ?? 'mês'}` : 'Sob consulta',
+            slug: plan.slug ?? plan.id,
+          })) ?? [],
+        );
+      })
+      .catch(console.error)
+      .finally(() => setLoading(false));
+  }, []);
+
+  if (loading) return <main className="p-8"><p>Carregando planos...</p></main>;
+
+  return (
+    <main className="p-8">
+      <h1 className="text-3xl font-bold mb-6">Planos</h1>
+      <div className="grid gap-4 md:grid-cols-3">
+        {plans.map((plan) => (
+          <article key={plan.id} className="border p-6 flex flex-col gap-4">
+            <div>
+              <h2 className="text-xl font-semibold">{plan.name}</h2>
+              <p className="text-2xl font-bold mt-2">{plan.price}</p>
+              {plan.description && (
+                <p className="text-sm text-zinc-600 mt-1">{plan.description}</p>
+              )}
+            </div>
+            <CheckoutLink
+              client={client}
+              productId={process.env.NEXT_PUBLIC_NEETRU_PRODUCT_ID!}
+              planId={plan.id}
+              callbackUrl={`${typeof window !== 'undefined' ? window.location.origin : ''}/billing/success`}
+              className="inline-block mt-auto px-4 py-2 bg-zinc-900 text-white text-center"
+            >
+              Assinar
+            </CheckoutLink>
+          </article>
+        ))}
+      </div>
+    </main>
+  );
+}

package/templates/billing/webhooks.ts

@@ -0,0 +1,83 @@
+/**
+ * Template — `src/app/api/webhooks/neetru/route.ts` (gerado por `neetru add billing`).
+ *
+ * Recebe webhooks do Neetru Core: subscription.activated, .cancelled,
+ * .payment_failed, .trial_ending e outros.
+ *
+ * O secret HMAC deve bater com o registrado via `neetru webhooks register`
+ * ou com NEETRU_WEBHOOK_SECRET no .env.local (dev).
+ *
+ * Pré-requisito: registrar o endpoint via:
+ *   neetru webhooks register --product-id <id> --url <URL> --events subscription.activated,subscription.cancelled,subscription.payment_failed
+ */
+import { NextRequest, NextResponse } from 'next/server';
+import { verifyWebhookRequest } from '@neetru/sdk/webhooks';
+
+export const runtime = 'nodejs';
+
+const WEBHOOK_SECRET = process.env.NEETRU_WEBHOOK_SECRET;
+
+interface WebhookPayload {
+  type: string;
+  data: Record<string, unknown>;
+  timestamp?: string;
+}
+
+async function handleSubscriptionActivated(data: Record<string, unknown>) {
+  const { subscriptionId, productId, tenantId } = data as Record<string, string>;
+  console.log('Assinatura ativada:', { subscriptionId, productId, tenantId });
+}
+
+async function handleSubscriptionCancelled(data: Record<string, unknown>) {
+  const { subscriptionId, productId, tenantId } = data as Record<string, string>;
+  console.log('Assinatura cancelada:', { subscriptionId, productId, tenantId });
+}
+
+async function handleSubscriptionPaymentFailed(data: Record<string, unknown>) {
+  const { subscriptionId, productId, tenantId } = data as Record<string, string>;
+  console.log('Pagamento falhou:', { subscriptionId, productId, tenantId });
+}
+
+async function handleTrialEnding(data: Record<string, unknown>) {
+  const { subscriptionId, productId, tenantId } = data as Record<string, string>;
+  console.log('Trial terminando:', { subscriptionId, productId, tenantId });
+}
+
+const HANDLERS: Record<string, (data: Record<string, unknown>) => Promise<void>> = {
+  'subscription.activated': handleSubscriptionActivated,
+  'subscription.cancelled': handleSubscriptionCancelled,
+  'subscription.payment_failed': handleSubscriptionPaymentFailed,
+  'subscription.trial_ending': handleTrialEnding,
+};
+
+export async function POST(request: NextRequest) {
+  if (!WEBHOOK_SECRET) {
+    return NextResponse.json(
+      { error: 'NEETRU_WEBHOOK_SECRET não configurado' },
+      { status: 500 },
+    );
+  }
+
+  const rawBody = await request.text();
+  const signature = request.headers.get('x-neetru-signature') ?? '';
+  const timestamp = request.headers.get('x-neetru-timestamp') ?? '';
+
+  const isValid = verifyWebhookRequest(rawBody, signature, WEBHOOK_SECRET, { timestamp });
+  if (!isValid) {
+    return NextResponse.json({ error: 'invalid_signature' }, { status: 401 });
+  }
+
+  let payload: WebhookPayload;
+  try {
+    payload = JSON.parse(rawBody);
+  } catch {
+    return NextResponse.json({ error: 'invalid_json' }, { status: 400 });
+  }
+
+  const handler = HANDLERS[payload.type];
+  if (handler) {
+    await handler(payload.data);
+  }
+
+  return NextResponse.json({ ok: true });
+}

package/templates/dev/Dockerfile.agent

@@ -0,0 +1,39 @@
+# Neetru Agent — modo dev (Docker container, sem systemd)
+# 
+# Em produção, o agente roda como systemd service na VM.
+# Em dev-local, roda como processo Node direto no container.
+# O deploy do app SaaS é feito como child process (não systemd unit).
+#
+# Build:
+#   docker build -f Dockerfile.agent -t neetru-agent-dev .
+
+FROM node:22-slim
+
+# Dependências do agente em produção (apt, certbot, etc.)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    curl ca-certificates systemctl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Diretório do agente
+WORKDIR /opt/neetru
+
+# Baixa o agente mais recente do Core
+ARG CORE_URL=https://core.neetru.com
+ENV NEETRU_CORE_URL=${CORE_URL}
+
+# Download do binário (fallback: usa curl se GCS não disponível)
+RUN ARCH=$(uname -m | sed 's/x86_64/x64/;s/aarch64/arm64/') && \
+    curl -fsSL -o /usr/local/bin/neetru-agent \
+    "${NEETRU_CORE_URL}/releases/latest/neetru-agent-linux-${ARCH}" || \
+    echo "Agente não encontrado no Core — será montado via volume" && \
+    chmod +x /usr/local/bin/neetru-agent || true
+
+# Entrypoint: agente em modo dev
+# - NEETRU_DEV_MODE=true desabilita systemd, usa child_process direto
+# - NEETRU_APP_PORT define a porta onde o app SaaS vai rodar
+COPY templates/dev/agent-entrypoint.sh /usr/local/bin/neetru-agent-entrypoint
+RUN chmod +x /usr/local/bin/neetru-agent-entrypoint
+
+EXPOSE 3000
+
+ENTRYPOINT ["/usr/local/bin/neetru-agent-entrypoint"]

package/templates/dev/agent-entrypoint.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Neetru Agent — entrypoint modo dev (Docker container)
+#
+# Em modo dev, o agente NAO usa systemd. Em vez disso:
+#   - Deploy = child process (npm install + node server)
+#   - Funções = child process (neetru-functions)
+#   - Healthcheck = /health endpoint no próprio agente
+#
+# Env vars obrigatórias:
+#   NEETRU_SERVER_ID       — id do servidor (ex: dev-local-meuproduto)
+#   NEETRU_CORE_URL        — URL do Core (ex: https://core.neetru.com)
+#   NEETRU_FIREBASE_PROJECT — projeto Firebase
+#   NEETRU_DEV_MODE        — "true" ativa modo dev
+
+set -e
+
+echo "═══════════════════════════════════════════"
+echo "  Neetru Agent — Dev Mode"
+echo "  Server: ${NEETRU_SERVER_ID}"
+echo "  Core:   ${NEETRU_CORE_URL}"
+echo "═══════════════════════════════════════════"
+
+# Verifica binário
+if [ ! -f /usr/local/bin/neetru-agent ]; then
+  echo "[AGENT] Binário não encontrado. Montando via volume..."
+  echo "[AGENT] Certifique-se de que o agente está em /opt/neetru/neetru-agent"
+  ls -la /opt/neetru/ || true
+fi
+
+# Cria diretórios necessários
+mkdir -p /var/cache/neetru /opt/neetru/deploys
+
+# Inicia o agente
+echo "[AGENT] Iniciando agente Neetru..."
+exec node /usr/local/bin/neetru-agent 2>&1 || exec node /opt/neetru/neetru-agent 2>&1 || {
+  echo "[AGENT] ERRO: Não foi possível iniciar o agente."
+  echo "[AGENT] Verifique se o binário existe em /usr/local/bin/neetru-agent"
+  echo "[AGENT] ou monte o binário via volume em /opt/neetru/neetru-agent"
+  sleep 10
+  exit 1
+}

package/templates/dev/docker-compose.dev.yml

@@ -0,0 +1,63 @@
+# Neetru Dev Local — emulador de VM ({{ENGINE}})
+# Gerado por `neetru dev up`. Modifique o neetru.config.json e rode novamente.
+#
+# Este compose simula uma VM de produção Neetru:
+#   1. Banco de dados ({{ENGINE}}) = mesmo engine que vai pra produção
+#   2. Agente Neetru = recebe comandos do Core, faz deploy, npm install, healthcheck
+#   3. App SaaS = deployado pelo agente, acessível em http://localhost:{{APP_PORT}}
+#
+# Uso:
+#   neetru dev up          # gera este compose + sobe tudo
+#   docker compose -f neetru-compose.dev.yml up -d   # manual
+#   docker compose -f neetru-compose.dev.yml down    # desliga
+
+services:
+  # ── Banco de dados ({{ENGINE}}) ────────────────────────────────────────────
+  database:
+    image: {{DB_IMAGE}}
+    container_name: neetru-dev-db
+    environment:
+{{DB_ENV}}
+    ports:
+      - "{{DB_PORT}}:{{DB_INTERNAL_PORT}}"
+    volumes:
+      - neetru-db-data:{{DB_DATA_DIR}}
+    healthcheck:
+{{DB_HEALTHCHECK}}
+    restart: unless-stopped
+    networks:
+      - neetru-dev-net
+
+  # ── Agente Neetru (modo dev — sem systemd) ────────────────────────────────
+  agent:
+    build:
+      context: .
+      dockerfile: Dockerfile.agent
+    container_name: neetru-dev-agent
+    environment:
+      - NEETRU_SERVER_ID=dev-local-{{PRODUCT_SLUG}}
+      - NEETRU_CORE_URL={{CORE_URL}}
+      - NEETRU_FIREBASE_PROJECT={{FIREBASE_PROJECT}}
+      - NEETRU_FIREBASE_API_KEY={{FIREBASE_API_KEY}}
+      - NEETRU_DEV_MODE=true
+      - NEETRU_APP_PORT={{APP_PORT}}
+    ports:
+      - "{{APP_PORT}}:{{APP_PORT}}"
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+      - neetru-agent-data:/var/cache/neetru
+      - .:/app/product:cached
+    depends_on:
+      database:
+        condition: service_healthy
+    restart: unless-stopped
+    networks:
+      - neetru-dev-net
+
+volumes:
+  neetru-db-data:
+  neetru-agent-data:
+
+networks:
+  neetru-dev-net:
+    driver: bridge

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>
+  );
+}

package/templates/usage/track.ts

@@ -1,30 +1,30 @@
-/**
- * Template — `src/lib/neetru/usage/track.ts` (gerado por `neetru add usage`).
- *
- * Helper para reportar uso de resources metered ao Core.
- *
- * @example
- * ```ts
- * import { reportApiCall } from '@/lib/neetru/usage/track';
- * await reportApiCall();
- * ```
- */
-import { createNeetruClient } from '@neetru/sdk';
-
-const client = createNeetruClient({
-  apiKey: process.env.NEETRU_API_KEY,
-  productId: process.env.NEETRU_PRODUCT_ID,
-  tenantId: process.env.NEETRU_TENANT_ID,
-});
-
-export async function reportApiCall(qty = 1): Promise<void> {
-  try {
-    await client.usage.report('api_calls', qty);
-  } catch (err) {
-    console.warn('usage.report failed', err);
-  }
-}
-
-export async function checkApiCallLimit() {
-  return client.usage.check('api_calls');
-}
+/**
+ * Template — `src/lib/neetru/usage/track.ts` (gerado por `neetru add usage`).
+ *
+ * Helper para reportar uso de resources metered ao Core.
+ *
+ * @example
+ * ```ts
+ * import { reportApiCall } from '@/lib/neetru/usage/track';
+ * await reportApiCall();
+ * ```
+ */
+import { createNeetruClient } from '@neetru/sdk';
+
+const client = createNeetruClient({
+  apiKey: process.env.NEETRU_API_KEY,
+  productId: process.env.NEETRU_PRODUCT_ID,
+  tenantId: process.env.NEETRU_TENANT_ID,
+});
+
+export async function reportApiCall(qty = 1): Promise<void> {
+  try {
+    await client.usage.report('api_calls', qty);
+  } catch (err) {
+    console.warn('usage.report failed', err);
+  }
+}
+
+export async function checkApiCallLimit() {
+  return client.usage.check('api_calls');
+}

package/templates/users/profile.tsx

@@ -1,43 +1,43 @@
-/**
- * Template — `src/lib/neetru/users/profile.tsx` (gerado por `neetru add users`).
- *
- * Componente de perfil mostra dados do user via SDK.
- */
-'use client';
-
-import { useEffect, useState } from 'react';
-import { createNeetruClient, type NeetruUser } from '@neetru/sdk';
-
-const client = createNeetruClient({
-  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
-});
-
-export function UserProfile() {
-  const [user, setUser] = useState<NeetruUser | null>(null);
-  useEffect(() => {
-    return client.auth.onAuthStateChanged(setUser);
-  }, []);
-
-  if (!user) return <p>Não autenticado.</p>;
-
-  return (
-    <div className="border p-4">
-      <p>
-        <strong>Nome:</strong> {user.displayName ?? '—'}
-      </p>
-      <p>
-        <strong>Email:</strong> {user.email}
-      </p>
-      <p>
-        <strong>UID:</strong> {user.uid}
-      </p>
-      <button
-        type="button"
-        onClick={() => client.auth.signOut()}
-        className="mt-4 px-3 py-1 border"
-      >
-        Sair
-      </button>
-    </div>
-  );
-}
+/**
+ * Template — `src/lib/neetru/users/profile.tsx` (gerado por `neetru add users`).
+ *
+ * Componente de perfil mostra dados do user via SDK.
+ */
+'use client';
+
+import { useEffect, useState } from 'react';
+import { createNeetruClient, type NeetruUser } from '@neetru/sdk';
+
+const client = createNeetruClient({
+  apiKey: process.env.NEXT_PUBLIC_NEETRU_API_KEY,
+});
+
+export function UserProfile() {
+  const [user, setUser] = useState<NeetruUser | null>(null);
+  useEffect(() => {
+    return client.auth.onAuthStateChanged(setUser);
+  }, []);
+
+  if (!user) return <p>Não autenticado.</p>;
+
+  return (
+    <div className="border p-4">
+      <p>
+        <strong>Nome:</strong> {user.displayName ?? '—'}
+      </p>
+      <p>
+        <strong>Email:</strong> {user.email}
+      </p>
+      <p>
+        <strong>UID:</strong> {user.uid}
+      </p>
+      <button
+        type="button"
+        onClick={() => client.auth.signOut()}
+        className="mt-4 px-3 py-1 border"
+      >
+        Sair
+      </button>
+    </div>
+  );
+}

package/dist/commands/fn.d.ts

@@ -1,6 +0,0 @@
-export interface FnDeployOptions {
-    version?: string;
-    channel?: 'stable' | 'beta' | 'alpha';
-    spec?: string;
-}
-export declare function runFnDeploy(opts?: FnDeployOptions): Promise<void>;