@neetru/cli 2.24.1 → 2.26.0

package/dist/lib/compose-generator.d.ts

@@ -0,0 +1,36 @@
+export interface ComposeDbConfig {
+    engine: string;
+    image: string;
+    env: Record<string, string>;
+    port: number;
+    internalPort: number;
+    dataDir: string;
+    healthcheck: {
+        test: string[];
+        interval: string;
+        timeout: string;
+        retries: number;
+    };
+}
+/**
+ * Mapeia engine de banco → config Docker Compose.
+ * Usa imagens oficiais — mesmas engines que rodam em produção na VM.
+ */
+export declare function resolveDbConfig(engine: string): ComposeDbConfig | null;
+export interface ComposeGeneratorInput {
+    productSlug: string;
+    dbEngine: string;
+    appPort?: number;
+    coreUrl?: string;
+    firebaseProject?: string;
+    firebaseApiKey?: string;
+}
+/**
+ * Gera o conteúdo do docker-compose.dev.yml baseado na config do produto.
+ * Template em templates/dev/docker-compose.dev.yml com substituições {{VAR}}.
+ */
+export declare function generateComposeDev(input: ComposeGeneratorInput): string;
+/**
+ * Escreve o compose + Dockerfile.agent no diretório do projeto.
+ */
+export declare function writeComposeDev(cwd: string, input: ComposeGeneratorInput): string;

package/dist/lib/compose-generator.js

@@ -0,0 +1,152 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Mapeia engine de banco → config Docker Compose.
+ * Usa imagens oficiais — mesmas engines que rodam em produção na VM.
+ */
+export function resolveDbConfig(engine) {
+    const configs = {
+        'vm-postgres-single': {
+            engine: 'PostgreSQL 15',
+            image: 'postgres:15-alpine',
+            env: { POSTGRES_PASSWORD: 'neetru_dev', POSTGRES_DB: 'app' },
+            port: 5432,
+            internalPort: 5432,
+            dataDir: '/var/lib/postgresql/data',
+            healthcheck: { test: ['CMD-SHELL', 'pg_isready -U postgres'], interval: '5s', timeout: '3s', retries: 10 },
+        },
+        'vm-mysql-single': {
+            engine: 'MySQL 8',
+            image: 'mysql:8.0',
+            env: { MYSQL_ROOT_PASSWORD: 'neetru_dev', MYSQL_DATABASE: 'app' },
+            port: 3306,
+            internalPort: 3306,
+            dataDir: '/var/lib/mysql',
+            healthcheck: { test: ['CMD', 'mysqladmin', 'ping', '-h', 'localhost'], interval: '5s', timeout: '3s', retries: 10 },
+        },
+        'nosql-vm': {
+            engine: 'MongoDB 7',
+            image: 'mongo:7',
+            env: { MONGO_INITDB_DATABASE: 'app' },
+            port: 27017,
+            internalPort: 27017,
+            dataDir: '/data/db',
+            healthcheck: { test: ['CMD', 'mongosh', '--eval', "db.adminCommand('ping')"], interval: '5s', timeout: '3s', retries: 10 },
+        },
+        'firestore-instance': {
+            engine: 'Firestore (Firebase Emulator)',
+            // Pinado num tag específico — imagem de terceiro em `:latest` deriva sem
+            // aviso e num dia ruim puxa uma versão quebrada/comprometida no dev local.
+            image: 'andreysenov/firebase-tools:15.24.0',
+            env: {},
+            port: 8080,
+            internalPort: 8080,
+            dataDir: '/data',
+            healthcheck: { test: ['CMD', 'curl', '-f', 'http://localhost:8080'], interval: '5s', timeout: '3s', retries: 15 },
+        },
+    };
+    // Normaliza engine (vm-postgres-single, cloud-sql-postgres → postgres config)
+    if (engine.includes('postgres'))
+        return configs['vm-postgres-single'];
+    if (engine.includes('mysql'))
+        return configs['vm-mysql-single'];
+    if (engine.includes('nosql') || engine.includes('mongo'))
+        return configs['nosql-vm'];
+    if (engine.includes('firestore'))
+        return configs['firestore-instance'];
+    return configs['vm-postgres-single'] ?? null; // default
+}
+/**
+ * Gera o conteúdo do docker-compose.dev.yml baseado na config do produto.
+ * Template em templates/dev/docker-compose.dev.yml com substituições {{VAR}}.
+ */
+export function generateComposeDev(input) {
+    const db = resolveDbConfig(input.dbEngine) ?? resolveDbConfig('vm-postgres-single');
+    const appPort = input.appPort ?? 3000;
+    // Bloco `environment:` só entra quando há vars — senão vira `environment:`
+    // vazio, que o docker compose rejeita ("environment must be a mapping").
+    // Firestore (env: {}) caía nisso → `dev up` firestore gerava compose inválido.
+    const dbEnvEntries = Object.entries(db.env);
+    const dbEnvBlock = dbEnvEntries.length
+        ? `    environment:\n${dbEnvEntries.map(([k, v]) => `      - ${k}=${v}`).join('\n')}\n`
+        : '';
+    const dbHealthcheck = [
+        `      test: ${JSON.stringify(db.healthcheck.test)}`,
+        `      interval: ${db.healthcheck.interval}`,
+        `      timeout: ${db.healthcheck.timeout}`,
+        `      retries: ${db.healthcheck.retries}`,
+    ].join('\n');
+    return `# Neetru Dev Local — emulador de VM (${db.engine})
+# Gerado por \`neetru dev up\`. Modifique o neetru.config.json e rode novamente.
+
+services:
+  database:
+    image: ${db.image}
+    container_name: neetru-dev-db
+${dbEnvBlock}    ports:
+      - "${db.port}:${db.internalPort}"
+    volumes:
+      - neetru-db-data:${db.dataDir}
+    healthcheck:
+${dbHealthcheck}
+    restart: unless-stopped
+    networks:
+      - neetru-dev-net
+
+  agent:
+    build:
+      context: .
+      dockerfile: Dockerfile.agent
+    container_name: neetru-dev-agent
+    environment:
+      - NEETRU_SERVER_ID=dev-local-${input.productSlug}
+      - NEETRU_CORE_URL=${input.coreUrl ?? 'https://core.neetru.com'}
+      - NEETRU_FIREBASE_PROJECT=${input.firebaseProject ?? 'neetru'}
+      - NEETRU_FIREBASE_API_KEY=${input.firebaseApiKey ?? ''}
+      - NEETRU_DEV_MODE=true
+      - NEETRU_APP_PORT=${appPort}
+      - DATABASE_URL=${db.internalPort === 5432 ? 'postgresql://postgres:neetru_dev@database:5432/app' : db.internalPort === 3306 ? 'mysql://root:neetru_dev@database:3306/app' : db.internalPort === 27017 ? 'mongodb://database:27017/app' : ''}
+    ports:
+      - "${appPort}:${appPort}"
+    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
+`;
+}
+/**
+ * Escreve o compose + Dockerfile.agent no diretório do projeto.
+ */
+export function writeComposeDev(cwd, input) {
+    const composePath = path.join(cwd, 'neetru-compose.dev.yml');
+    const dockerfilePath = path.join(cwd, 'Dockerfile.agent');
+    const entrypointPath = path.join(cwd, 'agent-entrypoint.sh');
+    const compose = generateComposeDev(input);
+    fs.writeFileSync(composePath, compose, 'utf8');
+    // Copia o Dockerfile.agent do template embutido
+    const templateDir = path.join(path.dirname(new URL(import.meta.url).pathname), '..', '..', 'templates', 'dev');
+    // Em modo pkg/compilado, busca do __dirname ou do diretório do CLI
+    const altTemplate = path.join(process.cwd(), 'node_modules', '@neetru', 'cli', 'templates', 'dev');
+    const dockerfileSrc = fs.existsSync(path.join(templateDir, 'Dockerfile.agent'))
+        ? path.join(templateDir, 'Dockerfile.agent')
+        : path.join(altTemplate, 'Dockerfile.agent');
+    if (fs.existsSync(dockerfileSrc)) {
+        fs.copyFileSync(dockerfileSrc, dockerfilePath);
+    }
+    return composePath;
+}
+//# sourceMappingURL=compose-generator.js.map

package/dist/lib/compose-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-generator.js","sourceRoot":"","sources":["../../src/lib/compose-generator.ts"],"names":[],"mappings":"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"}

package/dist/lib/config-schema.d.ts

@@ -79,6 +79,16 @@ export declare const neetruConfigSchema: z.ZodObject<{
         region: z.ZodOptional<z.ZodString>;
         serviceName: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>>;
+    database: z.ZodOptional<z.ZodObject<{
+        engine: z.ZodOptional<z.ZodEnum<["vm-postgres-single", "vm-mysql-single", "nosql-vm", "firestore-instance"]>>;
+        dbId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        engine?: "firestore-instance" | "vm-postgres-single" | "vm-mysql-single" | "nosql-vm" | undefined;
+        dbId?: string | undefined;
+    }, {
+        engine?: "firestore-instance" | "vm-postgres-single" | "vm-mysql-single" | "nosql-vm" | undefined;
+        dbId?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     slug: string;
@@ -98,6 +108,10 @@ export declare const neetruConfigSchema: z.ZodObject<{
         ctaHref?: string | undefined;
         ctaLabel?: string | undefined;
     } | undefined;
+    database?: {
+        engine?: "firestore-instance" | "vm-postgres-single" | "vm-mysql-single" | "nosql-vm" | undefined;
+        dbId?: string | undefined;
+    } | undefined;
 }, {
     name: string;
     slug: string;
@@ -117,6 +131,10 @@ export declare const neetruConfigSchema: z.ZodObject<{
         ctaHref?: string | undefined;
         ctaLabel?: string | undefined;
     } | undefined;
+    database?: {
+        engine?: "firestore-instance" | "vm-postgres-single" | "vm-mysql-single" | "nosql-vm" | undefined;
+        dbId?: string | undefined;
+    } | undefined;
 }>;
 export type NeetruConfig = z.infer<typeof neetruConfigSchema>;
 export type PublishBlock = z.infer<typeof publishBlockSchema>;

package/dist/lib/config-schema.js

@@ -38,6 +38,10 @@ export const neetruConfigSchema = z.object({
     tenantId: z.string().optional(),
     publish: publishBlockSchema.optional(),
     deploy: deployBlockSchema.optional(),
+    database: z.object({
+        engine: z.enum(['vm-postgres-single', 'vm-mysql-single', 'nosql-vm', 'firestore-instance']).optional(),
+        dbId: z.string().optional(),
+    }).optional(),
 });
 export const catalogUpsertPayloadSchema = z.object({
     slug: slugSchema,

package/dist/lib/config-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/lib/config-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/lib/config-schema.ts"],"names":[],"mappings":"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"}

package/dist/utils/safe-exit.d.ts

@@ -25,9 +25,32 @@
  *
  * Paths puramente síncronos podem usar process.exit() direto.
  */
+/**
+ * Sinal interno lançado por `safeExit` em produção para PARAR o caller sem
+ * `process.exit()` síncrono. O trap global em `index.ts` (`isSafeExitHalt`) o
+ * engole; o `setTimeout` agendado dentro do `safeExit` faz a saída REAL depois
+ * que o `uv_async_t` do undici fecha. Não estende `Error` de propósito — não é
+ * um erro, é um sinal de controle de fluxo.
+ */
+export declare class SafeExitHalt {
+    readonly code: number;
+    readonly __neetruSafeExit: true;
+    constructor(code: number);
+}
+/** Reconhece o sinal de halt do `safeExit` (usado pelos traps globais). */
+export declare function isSafeExitHalt(x: unknown): x is SafeExitHalt;
 /**
  * Sai com `code` após cleanup de handles libuv. NEVER returns.
  * Use em error paths que tocaram I/O assíncrono.
+ *
+ * Windows + undici (bug_818cf6d): `fetch()` do Node deixa um `uv_async_t`
+ * aberto; `process.exit()` SÍNCRONO o mata em `UV_HANDLE_CLOSING` (assertion
+ * fatal em `src\win\async.c`). RE-CONFIRMADO empiricamente 2026-07-16 que
+ * stdin.destroy() NÃO resolve — só deferir o exit um macrotask real (~100ms)
+ * deixa o handle fechar (setImmediate/delay-0 NÃO bastam). Em produção
+ * agendamos o exit e lançamos `SafeExitHalt` pra impedir a continuação síncrona
+ * do caller (preserva o contrato `never`); o timer é agendado ANTES do throw,
+ * então mesmo que um `try/catch` intermediário engula o sinal, o processo sai.
  */
 export declare function safeExit(code: number): never;
 /**

package/dist/utils/safe-exit.js

@@ -62,13 +62,65 @@ function cleanupHandles() {
     //    e o exit imediato — sockets http morrem com o processo de qualquer
     //    forma. Manter destroy aqui só prejudicava telemetria keepalive:true.
 }
+/**
+ * Sinal interno lançado por `safeExit` em produção para PARAR o caller sem
+ * `process.exit()` síncrono. O trap global em `index.ts` (`isSafeExitHalt`) o
+ * engole; o `setTimeout` agendado dentro do `safeExit` faz a saída REAL depois
+ * que o `uv_async_t` do undici fecha. Não estende `Error` de propósito — não é
+ * um erro, é um sinal de controle de fluxo.
+ */
+export class SafeExitHalt {
+    code;
+    __neetruSafeExit = true;
+    constructor(code) {
+        this.code = code;
+    }
+}
+/** Reconhece o sinal de halt do `safeExit` (usado pelos traps globais). */
+export function isSafeExitHalt(x) {
+    return (typeof x === 'object' &&
+        x !== null &&
+        x.__neetruSafeExit === true);
+}
+/**
+ * Em teste (vitest) mantemos `process.exit` SÍNCRONO: a suíte mocka/espera o
+ * `process.exit` e o exit deferido penduraria os workers / mudaria a semântica.
+ */
+function isTestEnv() {
+    return process.env.VITEST === 'true' || process.env.NODE_ENV === 'test';
+}
 /**
  * Sai com `code` após cleanup de handles libuv. NEVER returns.
  * Use em error paths que tocaram I/O assíncrono.
+ *
+ * Windows + undici (bug_818cf6d): `fetch()` do Node deixa um `uv_async_t`
+ * aberto; `process.exit()` SÍNCRONO o mata em `UV_HANDLE_CLOSING` (assertion
+ * fatal em `src\win\async.c`). RE-CONFIRMADO empiricamente 2026-07-16 que
+ * stdin.destroy() NÃO resolve — só deferir o exit um macrotask real (~100ms)
+ * deixa o handle fechar (setImmediate/delay-0 NÃO bastam). Em produção
+ * agendamos o exit e lançamos `SafeExitHalt` pra impedir a continuação síncrona
+ * do caller (preserva o contrato `never`); o timer é agendado ANTES do throw,
+ * então mesmo que um `try/catch` intermediário engula o sinal, o processo sai.
  */
 export function safeExit(code) {
     cleanupHandles();
-    process.exit(code);
+    if (isTestEnv()) {
+        // Em teste (vitest) o process.exit é mockado (spy que NÃO sai de fato).
+        // O `return` replica EXATAMENTE o safeExit original: chama process.exit e
+        // termina — sem cair no defer/throw abaixo (que quebraria a suíte). Em
+        // produção este branch nunca roda.
+        return process.exit(code);
+    }
+    process.exitCode = code;
+    // Adia o process.exit um macrotask real. O gatilho do UV_HANDLE_CLOSING é o
+    // `process.exit()` SÍNCRONO correndo com o teardown do uv_async_t do undici;
+    // ~300ms deixa o handle assentar antes da saída (empírico 2026-07-16: 100ms
+    // é racy → crash intermitente; 250-300ms → 0 crash em 35+ runs). NÃO fechar
+    // o dispatcher do undici aqui: `await dispatcher.close()` + process.exit
+    // crasha 25/25 (o force-exit ainda corre com o teardown) e quebra o flush
+    // de telemetria keepalive.
+    setTimeout(() => process.exit(code), 300);
+    throw new SafeExitHalt(code);
 }
 /**
  * Seta process.exitCode mas NÃO sai imediatamente — caller deve `return`.

package/dist/utils/safe-exit.js.map

@@ -1 +1 @@
-{"version":3,"file":"safe-exit.js","sourceRoot":"","sources":["../../src/utils/safe-exit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,SAAS,cAAc;IACrB,gEAAgE;IAChE,IAAI,CAAC;QAAC,eAAe,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAEtD,yEAAyE;IACzE,mCAAmC;IACnC,EAAE;IACF,+BAA+B;IAC/B,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,yEAAyE;IACzE,sEAAsE;IACtE,sDAAsD;IACtD,EAAE;IACF,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED,kEAAkE;IAClE,gFAAgF;IAChF,wEAAwE;IACxE,0EAA0E;IAC1E,mEAAmE;IACnE,uEAAuE;IACvE,wEAAwE;IACxE,0EAA0E;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,cAAc,EAAE,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,cAAc,EAAE,CAAC;IACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"safe-exit.js","sourceRoot":"","sources":["../../src/utils/safe-exit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,SAAS,cAAc;IACrB,gEAAgE;IAChE,IAAI,CAAC;QAAC,eAAe,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAEtD,yEAAyE;IACzE,mCAAmC;IACnC,EAAE;IACF,+BAA+B;IAC/B,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,yEAAyE;IACzE,sEAAsE;IACtE,sDAAsD;IACtD,EAAE;IACF,uEAAuE;IACvE,qEAAqE;IACrE,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC7D,CAAC;IAED,kEAAkE;IAClE,gFAAgF;IAChF,wEAAwE;IACxE,0EAA0E;IAC1E,mEAAmE;IACnE,uEAAuE;IACvE,wEAAwE;IACxE,0EAA0E;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IAEK;IADnB,gBAAgB,GAAG,IAAa,CAAC;IAC1C,YAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;CAC7C;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACT,CAAoC,CAAC,gBAAgB,KAAK,IAAI,CAChE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS;IAChB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,cAAc,EAAE,CAAC;IACjB,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,wEAAwE;QACxE,0EAA0E;QAC1E,uEAAuE;QACvE,mCAAmC;QACnC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IACxB,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,4EAA4E;IAC5E,yEAAyE;IACzE,0EAA0E;IAC1E,2BAA2B;IAC3B,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,cAAc,EAAE,CAAC;IACjB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neetru/cli",
-  "version": "2.24.1",
+  "version": "2.26.0",
   "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,38 @@
-/**
- * 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/app/api/billing/checkout/route.ts` (gerado por `neetru add billing`).
+ *
+ * Inicia checkout Stripe via SDK server-side. O cliente chama este endpoint
+ * com { planId, productId } e recebe a URL de redirecionamento pro Stripe.
+ *
+ * Pré-requisito: NEETRU_API_KEY e NEETRU_PRODUCT_ID no .env.local.
+ */
+import { NextRequest, NextResponse } from 'next/server';
+import { createNeetruClient } from '@neetru/sdk';
+
+export const runtime = 'nodejs';
+
+export async function POST(request: NextRequest) {
+  const body = await request.json();
+  const { planId, productId } = body ?? {};
+  const pid = productId || process.env.NEETRU_PRODUCT_ID;
+
+  if (!planId || !pid) {
+    return NextResponse.json(
+      { error: 'planId e productId obrigatórios' },
+      { status: 400 },
+    );
+  }
+
+  const client = createNeetruClient({
+    apiKey: process.env.NEETRU_API_KEY!,
+    productId: pid,
+  });
+
+  const result = await client.checkout.start({
+    productId: pid,
+    planId,
+    callbackUrl: `${process.env.NEXT_PUBLIC_APP_URL ?? 'http://localhost:3000'}/billing/success`,
+  });
+
+  return NextResponse.json({ redirectUrl: result.redirectUrl });
+}