docs: registrar fluxo do updater e atualizar chaves

src/app/api/machines/session/route.ts

@@ -0,0 +1,77 @@
+import { NextResponse } from "next/server"
+import { cookies } from "next/headers"
+import { ConvexHttpClient } from "convex/browser"
+
+import { api } from "@/convex/_generated/api"
+import type { Id } from "@/convex/_generated/dataModel"
+import { env } from "@/lib/env"
+import { assertAuthenticatedSession } from "@/lib/auth-server"
+
+const MACHINE_CTX_COOKIE = "machine_ctx"
+
+function decodeMachineCookie(value: string) {
+  try {
+    const json = Buffer.from(value, "base64url").toString("utf8")
+    return JSON.parse(json) as {
+      machineId: string
+      persona: string | null
+      assignedUserId: string | null
+      assignedUserEmail: string | null
+      assignedUserName: string | null
+      assignedUserRole: string | null
+    }
+  } catch {
+    return null
+  }
+}
+
+export async function GET() {
+  const session = await assertAuthenticatedSession()
+  if (!session || session.user?.role !== "machine") {
+    return NextResponse.json({ error: "Sessão de máquina não encontrada." }, { status: 403 })
+  }
+
+  const cookieStore = await cookies()
+  const cookieValue = cookieStore.get(MACHINE_CTX_COOKIE)?.value
+  if (!cookieValue) {
+    return NextResponse.json({ error: "Contexto da máquina ausente." }, { status: 404 })
+  }
+
+  const decoded = decodeMachineCookie(cookieValue)
+  if (!decoded?.machineId) {
+    return NextResponse.json({ error: "Contexto da máquina inválido." }, { status: 400 })
+  }
+
+  const convexUrl = env.NEXT_PUBLIC_CONVEX_URL
+  if (!convexUrl) {
+    return NextResponse.json({ error: "Convex não configurado." }, { status: 500 })
+  }
+
+  const client = new ConvexHttpClient(convexUrl)
+
+  try {
+    const context = (await client.query(api.machines.getContext, {
+      machineId: decoded.machineId as Id<"machines">,
+    })) as {
+      id: string
+      tenantId: string
+      companyId: string | null
+      companySlug: string | null
+      persona: string | null
+      assignedUserId: string | null
+      assignedUserEmail: string | null
+      assignedUserName: string | null
+      assignedUserRole: string | null
+      metadata: Record<string, unknown> | null
+      authEmail: string | null
+    }
+
+    return NextResponse.json({
+      machine: context,
+      cookie: decoded,
+    })
+  } catch (error) {
+    console.error("[machines.session] Falha ao obter contexto da máquina", error)
+    return NextResponse.json({ error: "Falha ao obter contexto da máquina." }, { status: 500 })
+  }
+}